• JAVIER ESTRADA (24/24) Feb 25 2004 Matthew,
• Matthew (229/253) Feb 25 2004 CoUninitialize.
• Matthew (234/294) Feb 25 2004 No time like the present. Here's the policy-based version.

"JAVIER ESTRADA" <ljestrada verizon.net> writes:

Matthew,

I missed a RAII that wraps the calls to CoInitialize(Ex) and CoUninitialize.
I make heavy use of such a simple wrapper, and it can serve as a base class
for "active" classes--those that create their own thread and enter a COM
apartment, or as an automatic variable when entering COM is necessary for
the length of a function call:

#ifndef _WIN32_DCOM
#define _WIN32_DCOM
#endif

#include <windef.h>   // DWORD
#include <winerror.h> // FAILED, SUCCEEDED macros
#include <objbase.h>  // CoInitializeEx, CoUninitialize

class CoInitializer
{
  CoInitializer(CoInitializer const&);
  CoInitializer& operator=(CoInitializer const&);

public:

  explicit CoInitializer(DWORD dwCoInit = COINIT_APARTMENTTHREADED)
  {
    if (FAILED(::CoInitializeEx(0, dwCoInit)))
      /*a throw clause here if desired*/;
  }

  ~CoInitializer() { ::CoUninitialize(); }
};

"Matthew" <matthew.hat stlsoft.dot.org> writes:

"JAVIER ESTRADA" <ljestrada verizon.net> wrote in message
news:c1judk$1knu$1 digitaldaemon.com...
 Matthew,

 I missed a RAII that wraps the calls to CoInitialize(Ex) and

CoUninitialize.
 I make heavy use of such a simple wrapper, and it can serve as a base

class
 for "active" classes--those that create their own thread and enter a COM
 apartment, or as an automatic variable when entering COM is necessary for
 the length of a function call:

Check out comstl_initialisers.h, which contains the com_initialiser and
ole_initialiser classes. There's a test program in the
test\comstl\initialisers_test subdirectory.

They currently use a half-hearted mechanism to attempt to prevent
inheritance, so may not serve your needs in their current form.

There's also a problem with them is that they're not spelled correctly for
US-English speakers, so I'm adding the appropriate typedefs in the next
version. This may be how you missed them (although I would have assumed that
you'd grep for CoInitialize.)

However, I'm including the latest version, which have these issues addressed
now.

 #ifndef _WIN32_DCOM
 #define _WIN32_DCOM
 #endif

 #include <windef.h>   // DWORD
 #include <winerror.h> // FAILED, SUCCEEDED macros
 #include <objbase.h>  // CoInitializeEx, CoUninitialize

 class CoInitializer
 {
   CoInitializer(CoInitializer const&);
   CoInitializer& operator=(CoInitializer const&);

 public:

   explicit CoInitializer(DWORD dwCoInit = COINIT_APARTMENTTHREADED)
   {
     if (FAILED(::CoInitializeEx(0, dwCoInit)))
       /*a throw clause here if desired*/;
   }

   ~CoInitializer() { ::CoUninitialize(); }
 };

This is wrong! You need to match a call to CoUninitialize() *only* with a
successful call to CoInitialize(), CoInitializeEx(), and the same follows
for OleInitialize() and OleUninitialize(). MSDN says:

"A thread must call CoUninitialize once for each successful call it has made
to CoInitialize or CoInitializeEx. Only the CoUninitialize call
corresponding to the CoInitialize or CoInitializeEx call that initialized
the library can close it."


I'm including the latest version here. This will get into 1.7.1, so you are
pretty safe using it as is.

btw, I'm thinking of changing them to allow for parameterisation by an
error-handling policy, so as to throw exceptions if it fails. But don't
worry, as I'll make sure that all current typenames will be valid
instantiations of the templates with the same semantics as they now have. :)

Cheers

Matthew


begin 666 comstl_initialisers.h
M+RH +R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\-"B J($9I;&4Z
M("  ("  ("!C;VUS=&Q?:6YI=&EA;&ES97)S+F  *&]R:6=I;F%L;'D 34])
M;FET+F L(#HZ4WEN97-I

M("H 0W)E871E9#H ("  (#AT


M* T*("H 3&EC96YS93H ("  ("A,:6-E;G-E9"!U;F1E<B!T:&4 4WEN97-I




M("  :'1T<#HO+W=W=RYS>6YE<VES+F-O;2YA=2]C;VUS=&P-"B J("  ("  

M* T*("H ("  ("  ("  ("  (&5M86EL.B  ("  ('-U8FUI<W-I;VYS0&-O
M;7-T;"YO<F< (&9O<B!S=6)M:7-S:6]N<PT*("H ("  ("  ("  ("  ("  
M("  ("  ("  (&%D;6EN0&-O;7-T;"YO<F< ("  ("  (&9O<B!O=&AE<B!E

M86YD('5S92!I;B!S;W5R8V4 86YD(&)I;F%R>2!F;W)M<RP =VET:"!O< T*
M("H ("  ("  ("  ("  ('=I=&AO=70 ;6]D:69I8V%T:6]N+"!A<F4 <&5R
M;6ET=&5D('!R;W9I9&5D('1H870 =&AE(&9O;&QO=VEN9PT*("H ("  ("  
M("  ("  (&-O;F1I=&EO;G, 87)E(&UE=#H-
M("  *&DI(%)E9&ES=')I8G5T:6]N<R!O9B!S;W5R8V4 8V]D92!M=7-T(')E
M=&%I;B!T:&4 86)O=F4-"B J("  ("  ("  ("  ("!C;W!Y<FEG:'0 ;F]T
M:6-E(&%N9"!C;VYT86-T(&EN9F]R;6%T:6]N+"!T:&ES(&QI<W0 ;V8-"B J
M("  ("  ("  ("  ("!C;VYD:71I;VYS(&%N9"!T:&4 9F]L;&]W:6YG(&1I

M960 =F5R<VEO;G, ;V8 =&AI<R!S;V9T=V%R92 H:&]W<V]E=F5R(&UO9&EF
M:65D*0T*("H ("  ("  ("  ("  (')E;6%I;B!T:&4 <V]L92!P<F]P97)T
M>2!O9B!3>6YE<VES(%-O9G1W87)E+ T*("H-"B J("  ("  ("  ("  (" H
M:6EI*2!!;GD 9&5R:79E9"!V97)S:6]N<R!O9B!T:&ES('-O9G1W87)E("AH


M("  ("  ("AI=BD 3F5I=&AE<B!T:&4 ;F%M92!O9B!3>6YE<VES(%-O9G1W

M9&EV:7-I;VYS+"!E;7!L;WEE97, ;W( 86=E;G1S(&]F(%-Y;F5S:7, 4V]F
M='=A<F4L(&YO<B!T:&4-"B J("  ("  ("  ("  ("!N86UE<R!O9B!A;GD 
M;W1H97( 8V]N=')I8G5T;W)S('1O('1H:7, <V]F='=A<F4 ;6%Y(&)E('5S
M960 =&\-"B J("  ("  ("  ("  ("!E;F1O<G-E(&]R('!R;VUO=&4 <')O
M9'5C=', 9&5R:79E9"!F<F]M('1H:7, <V]F='=A<F4 =VET:&]U= T*("H 
M("  ("  ("  ("  ('-P96-I9FEC('!R:6]R('=R:71T96X <&5R;6ES<VEO

M<F]V:61E9"!B>2!3>6YE<VES(%-O9G1W87)E(")A<R!I<R( 86YD(&%N>0T*
M("H ("  ("  ("  ("  ('=A<G)A;G1I97,L('=H971H97( 97AP<F5S<V5D
M(&]R(&EM<&QI960L(&EN8VQU9&EN9RP 8G5T(&YO= T*("H ("  ("  ("  
M("  (&QI;6ET960 =&\L('1H92!I;7!L:65D('=A<G)A;G1I97, ;V8 ;65R
M8VAA;G1A8FEL:71Y(&%N9 T*("H ("  ("  ("  ("  (&9I=&YE<W, 9F]R
M(&$ <&%R=&EC=6QA<B!P=7)P;W-E(&%R92!D:7-C;&%I;65D+B!);B!N;R!E
M=F5N= T*("H ("  ("  ("  ("  ('-H86QL('1H92!3>6YE<VES(%-O9G1W

M("  ("  ("  ("  :6YC:61E;G1A;"P <W!E8VEA;"P 97AE;7!L87)Y+"!O
M<B!C;VYS97%U96YT:6%L(&1A;6%G97,-"B J("  ("  ("  ("  (" H:6YC
M;'5D:6YG+"!B=70 ;F]T(&QI;6ET960 =&\L('!R;V-U<F5M96YT(&]F('-U
M8G-T:71U=&4 9V]O9',-"B J("  ("  ("  ("  ("!O<B!S97)V:6-E<SL 

M*B  ("  ("  ("  ("  :6YT97)R=7!T:6]N*2!H;W=E=F5R(&-A=7-E9"!A

M("  =VAE=&AE<B!I;B!C;VYT<F%C="P <W1R:6-T(&QI86)I;&ET>2P ;W( 

M<B!O=&AE<G=I<V4I(&%R:7-I;F< :6X 86YY('=A>2!O=70 ;V8 =&AE('5S
M92!O9 T*("H ("  ("  ("  ("  ('1H:7, <V]F='=A<F4L(&5V96X :68 
M861V:7-E9"!O9B!T:&4 <&]S<VEB:6QI='D ;V8 <W5C: T*("H ("  ("  

M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O






M0T]-4U1,7U9%4E](7T-/35-43%])3DE424%,25-%4E-?4D5625-)3TX ,0T*



M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O


M("  ("  ("\O($EN8VQU9&4 =&AE($-/35-43"!R;V]T(&AE861E< T*(V5N

M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O

M("H 5&AE($-/35-43"!C;VUP;VYE;G1S(&%R92!C;VYT86EN960 =VET:&EN

M;B!A;&EA<R!F;W( <W1L<V]F=#HZ8V



M+2T ("  +2TM+2TM+2TM+2TM+2TM+2TM+2T ("  +2TM+2TM+2TM+2TM+2TM
M+2T-"B J("!N;W0 9&5F:6YE9"  ("  ("  ("  ("  ;F]T(&1E9FEN960 
M("  ("  ("  ("  /2!S=&QS;V9T.CIC;VUS=&Q?<')O:F5C= T*("H (&YO
M="!D969I;F5D("  ("  ("  ("  ("!D969I;F5D("  ("  ("  ("  ("  
M("!N;W0 9&5F:6YE9 T*("H (&1E9FEN960 ("  ("  ("  ("  ("  ("!N
M;W0 9&5F:6YE9"  ("  ("  ("  ("!C;VUS=&P-"B J("!D969I;F5D("  
M("  ("  ("  ("  ("  9&5F:6YE9"  ("  ("  ("  ("  ("  ;F]T(&1E

M10T*(R!I9F1E9B!?4U1,4T]&5%].3U].04U%4U!!0T4-"B\J(%1H97)E(&ES
M(&YO('-T;'-O9G0 ;F%M97-P86-E+"!S;R!M=7-T(&1E9FEN92 Z.F-O;7-T

M<W1L<V]F=#HZ8V]M<W1L7W!R;VIE8W0 *B\-" T*;F%M97-P86-E('-T;'-O



M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O


M(&ES('5S960 =&\ :6YI=&EA;&ES92!T:&4 0T]-(&QI8G)A<FEE<RX 268 

M;&%G<R!W:&5N('1R86YS;&%T960 :6X 82!$0T]-(&)U:6QD+ T*8VQA<W, 

M7VEN:71I86QI<V5R("  8VQA<W-?='EP93L-" T*+R\ 0V]N<W1R=6-T:6]N

M>F4H*0T*("  (&-O;5]I;FET:6%L:7-E<B I.PT*(VEF9&5F(%]?0T]-4U1,


M("!S<U]E>'!L:6-I=%]K(&-O;5]I;FET:6%L:7-E<BA$5T]21"!D=TEN:70 




M8FQI8SH-"B  (" O+R\ 4F5F;&5C=', =VAE=&AE<B!T:&4 0T]-(&QI8G)A


M($-/32!L:6)R87)I97, =V5R92!N;W0 :6YI=&EA;&ES960-"B  ("!C<U]B
M;V]L7W0 ;W!E<F%T;W( (2 I(&-O;G-T.PT*("  ("\O+R!4:&4 <F5S=6QT
M(&]F('1H92!C86QL('1O($-O26YI=&EA;&EZ92 I+T-O26YI=&EA;&EZ945X


M"B\O($YO="!T;R!B92!I;7!L96UE;G1E9 T*<')I=F%T93H-"B  ("!C;VU?
M:6YI=&EA;&ES97(H8VQA<W-?='EP92!C;VYS=" F<FAS*3L-"B  ("!C;&%S
M<U]T>7!E(&-O;G-T("9O<&5R871O<B ]*&-L87-S7W1Y<&4 8V]N<W0 )G)H

M"B\O+PT*+R\O(%1H:7, 8VQA<W, :7, =7-E9"!T;R!I;FET:6%L:7-E('1H

M<FEV871E. T*("  ('1Y<&5D968 ;VQE7VEN:71I86QI<V5R("!C;&%S<U]T

M=&EA;&ES97, =FEA($]L94EN:71I86QI>F4H*0T*("  (&]L95]I;FET:6%L
M:7-E<B I.PT*("  ("\O+R!);FET:6%L:7-E<R!V:6$ 3VQE56YI;FET:6%L
M:7IE*"D-"B  ("!^;VQE7VEN:71I86QI<V5R*"D 8V]M<W1L7W1H<F]W7S H
M*3L-" T*+R\ 071T<FEB=71E<PT*<'5B;&EC. T*("  ("\O+R!2969L96-T
M<R!W:&5T:&5R('1H92!/3$4 ;&EB<F%R:65S('=E<F4 :6YI=&EA;&ES960-
M"B  ("!C<U]B;V]L7W0 :7-?:6YI=&EA;&ES960H*2!C;VYS=#L-"B  (" O
M+R\ 4F5F;&5C=', =VAE=&AE<B!T:&4 3TQ%(&QI8G)A<FEE<R!W97)E(&YO
M="!I;FET:6%L:7-E9 T*("  (&-S7V)O;VQ?="!O<&5R871O<B A*"D 8V]N





M("  8VQA<W-?='EP92!C;VYS=" F;W!E<F%T;W( /2AC;&%S<U]T>7!E(&-O
M;G-T("9R:',I.PT*?3L-" T*+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\-"B\O(%1Y<&5D969S(&9O<B!54RU%;F=L:7-H('-P96QL97)S

M"G1Y<&5D968 ;VQE7VEN:71I86QI<V5R"6]L95]I;FET:6%L:7IE<CL-" T*
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\-"B\O($EM<&QE

M7VEN:71I86QI<V5R.CIC;VU?:6YI=&EA;&ES97(H*0T*("  (#H ;5]H<B Z

M1E]$0T]-7U-54%!/4E0-"FEN;&EN92!C;VU?:6YI=&EA;&ES97(Z.F-O;5]I







M<F5T=7)N(%-50T-%141%1"AM7VAR*3L-"GT-" T*:6YL:6YE(&-S7V)O;VQ?
M="!C;VU?:6YI=&EA;&ES97(Z.F]P97)A=&]R("$H*2!C;VYS= T*>PT*("  
M(')E='5R;B A:7-?:6YI=&EA;&ES960H*3L-"GT-" T*:6YL:6YE($A215-5


M;FQI;F4 ;VQE7VEN:71I86QI<V5R.CIO;&5?:6YI=&EA;&ES97(H*0T*("  
M(#H
M;VQE7VEN:71I86QI<V5R.CI^;VQE7VEN:71I86QI<V5R*"D 8V]M<W1L7W1H

M("  ("  (" Z.D]L955N:6YI=&EA;&EZ92 I.PT*("  ('T-"GT-" T*:6YL
M:6YE(&-S7V)O;VQ?="!O;&5?:6YI=&EA;&ES97(Z.FES7VEN:71I86QI<V5D




M54Q4*"D 8V]N<W0-"GL-"B  ("!R971U<FX ;5]H<CL-"GT-" T*+RH +R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\ *B\-" T*(VEF;F1E9B!?0T]-


M<&%C92!S=&QS;V9T.CIC;VUS=&Q?<')O:F5C= T*?2 O+R!N86UE<W!A8V4 
M<W1L<V]F= T*(R!E;F1I9B O*B!?4U1,4T]&5%].3U].04U%4U!!0T4 *B\-
M"B-E;F1I9B O*B A7T-/35-43%].3U].04U%4U!!0T4 *B\-" T*+RH +R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O


M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
?+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\ *B\-" ``
`
end

"Matthew" <matthew.hat stlsoft.dot.org> writes:

No time like the present. Here's the policy-based version.

Thanks for providing the impetus. :)

Matthew


"Matthew" <matthew.hat stlsoft.dot.org> wrote in message
news:c1k3b1$1tg4$1 digitaldaemon.com...
 "JAVIER ESTRADA" <ljestrada verizon.net> wrote in message
 news:c1judk$1knu$1 digitaldaemon.com...
 Matthew,

 I missed a RAII that wraps the calls to CoInitialize(Ex) and

 CoUninitialize.
 I make heavy use of such a simple wrapper, and it can serve as a base

 class
 for "active" classes--those that create their own thread and enter a COM
 apartment, or as an automatic variable when entering COM is necessary


for
 the length of a function call:

 Check out comstl_initialisers.h, which contains the com_initialiser and
 ole_initialiser classes. There's a test program in the
 test\comstl\initialisers_test subdirectory.

 They currently use a half-hearted mechanism to attempt to prevent
 inheritance, so may not serve your needs in their current form.

 There's also a problem with them is that they're not spelled correctly for
 US-English speakers, so I'm adding the appropriate typedefs in the next
 version. This may be how you missed them (although I would have assumed

that
 you'd grep for CoInitialize.)

 However, I'm including the latest version, which have these issues

addressed
 now.

 #ifndef _WIN32_DCOM
 #define _WIN32_DCOM
 #endif

 #include <windef.h>   // DWORD
 #include <winerror.h> // FAILED, SUCCEEDED macros
 #include <objbase.h>  // CoInitializeEx, CoUninitialize

 class CoInitializer
 {
   CoInitializer(CoInitializer const&);
   CoInitializer& operator=(CoInitializer const&);

 public:

   explicit CoInitializer(DWORD dwCoInit = COINIT_APARTMENTTHREADED)
   {
     if (FAILED(::CoInitializeEx(0, dwCoInit)))
       /*a throw clause here if desired*/;
   }

   ~CoInitializer() { ::CoUninitialize(); }
 };

 This is wrong! You need to match a call to CoUninitialize() *only* with a
 successful call to CoInitialize(), CoInitializeEx(), and the same follows
 for OleInitialize() and OleUninitialize(). MSDN says:

 "A thread must call CoUninitialize once for each successful call it has

made
 to CoInitialize or CoInitializeEx. Only the CoUninitialize call
 corresponding to the CoInitialize or CoInitializeEx call that initialized
 the library can close it."


 I'm including the latest version here. This will get into 1.7.1, so you

are
 pretty safe using it as is.

 btw, I'm thinking of changing them to allow for parameterisation by an
 error-handling policy, so as to throw exceptions if it fails. But don't
 worry, as I'll make sure that all current typenames will be valid
 instantiations of the templates with the same semantics as they now have.

:)
 Cheers

 Matthew


begin 666 comstl_initialisers.h
M+RH +R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\-"B J($9I;&4Z
M("  ("  ("!C;VUS=&Q?:6YI=&EA;&ES97)S+F  *&]R:6=I;F%L;'D 34])
M;FET+F L(#HZ4WEN97-I

M("H 0W)E871E9#H ("  (#AT


M* T*("H 3&EC96YS93H ("  ("A,:6-E;G-E9"!U;F1E<B!T:&4 4WEN97-I




M("  :'1T<#HO+W=W=RYS>6YE<VES+F-O;2YA=2]C;VUS=&P-"B J("  ("  

M* T*("H ("  ("  ("  ("  (&5M86EL.B  ("  ('-U8FUI<W-I;VYS0&-O
M;7-T;"YO<F< (&9O<B!S=6)M:7-S:6]N<PT*("H ("  ("  ("  ("  ("  
M("  ("  ("  (&%D;6EN0&-O;7-T;"YO<F< ("  ("  (&9O<B!O=&AE<B!E

M86YD('5S92!I;B!S;W5R8V4 86YD(&)I;F%R>2!F;W)M<RP =VET:"!O< T*
M("H ("  ("  ("  ("  ('=I=&AO=70 ;6]D:69I8V%T:6]N+"!A<F4 <&5R
M;6ET=&5D('!R;W9I9&5D('1H870 =&AE(&9O;&QO=VEN9PT*("H ("  ("  
M("  ("  (&-O;F1I=&EO;G, 87)E(&UE=#H-
M("  *&DI(%)E9&ES=')I8G5T:6]N<R!O9B!S;W5R8V4 8V]D92!M=7-T(')E
M=&%I;B!T:&4 86)O=F4-"B J("  ("  ("  ("  ("!C;W!Y<FEG:'0 ;F]T
M:6-E(&%N9"!C;VYT86-T(&EN9F]R;6%T:6]N+"!T:&ES(&QI<W0 ;V8-"B J
M("  ("  ("  ("  ("!C;VYD:71I;VYS(&%N9"!T:&4 9F]L;&]W:6YG(&1I

M960 =F5R<VEO;G, ;V8 =&AI<R!S;V9T=V%R92 H:&]W<V]E=F5R(&UO9&EF
M:65D*0T*("H ("  ("  ("  ("  (')E;6%I;B!T:&4 <V]L92!P<F]P97)T
M>2!O9B!3>6YE<VES(%-O9G1W87)E+ T*("H-"B J("  ("  ("  ("  (" H
M:6EI*2!!;GD 9&5R:79E9"!V97)S:6]N<R!O9B!T:&ES('-O9G1W87)E("AH


M("  ("  ("AI=BD 3F5I=&AE<B!T:&4 ;F%M92!O9B!3>6YE<VES(%-O9G1W

M9&EV:7-I;VYS+"!E;7!L;WEE97, ;W( 86=E;G1S(&]F(%-Y;F5S:7, 4V]F
M='=A<F4L(&YO<B!T:&4-"B J("  ("  ("  ("  ("!N86UE<R!O9B!A;GD 
M;W1H97( 8V]N=')I8G5T;W)S('1O('1H:7, <V]F='=A<F4 ;6%Y(&)E('5S
M960 =&\-"B J("  ("  ("  ("  ("!E;F1O<G-E(&]R('!R;VUO=&4 <')O
M9'5C=', 9&5R:79E9"!F<F]M('1H:7, <V]F='=A<F4 =VET:&]U= T*("H 
M("  ("  ("  ("  ('-P96-I9FEC('!R:6]R('=R:71T96X <&5R;6ES<VEO

M<F]V:61E9"!B>2!3>6YE<VES(%-O9G1W87)E(")A<R!I<R( 86YD(&%N>0T*
M("H ("  ("  ("  ("  ('=A<G)A;G1I97,L('=H971H97( 97AP<F5S<V5D
M(&]R(&EM<&QI960L(&EN8VQU9&EN9RP 8G5T(&YO= T*("H ("  ("  ("  
M("  (&QI;6ET960 =&\L('1H92!I;7!L:65D('=A<G)A;G1I97, ;V8 ;65R
M8VAA;G1A8FEL:71Y(&%N9 T*("H ("  ("  ("  ("  (&9I=&YE<W, 9F]R
M(&$ <&%R=&EC=6QA<B!P=7)P;W-E(&%R92!D:7-C;&%I;65D+B!);B!N;R!E
M=F5N= T*("H ("  ("  ("  ("  ('-H86QL('1H92!3>6YE<VES(%-O9G1W

M("  ("  ("  ("  :6YC:61E;G1A;"P <W!E8VEA;"P 97AE;7!L87)Y+"!O
M<B!C;VYS97%U96YT:6%L(&1A;6%G97,-"B J("  ("  ("  ("  (" H:6YC
M;'5D:6YG+"!B=70 ;F]T(&QI;6ET960 =&\L('!R;V-U<F5M96YT(&]F('-U
M8G-T:71U=&4 9V]O9',-"B J("  ("  ("  ("  ("!O<B!S97)V:6-E<SL 

M*B  ("  ("  ("  ("  :6YT97)R=7!T:6]N*2!H;W=E=F5R(&-A=7-E9"!A

M("  =VAE=&AE<B!I;B!C;VYT<F%C="P <W1R:6-T(&QI86)I;&ET>2P ;W( 

M<B!O=&AE<G=I<V4I(&%R:7-I;F< :6X 86YY('=A>2!O=70 ;V8 =&AE('5S
M92!O9 T*("H ("  ("  ("  ("  ('1H:7, <V]F='=A<F4L(&5V96X :68 
M861V:7-E9"!O9B!T:&4 <&]S<VEB:6QI='D ;V8 <W5C: T*("H ("  ("  

M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O






M0T]-4U1,7U9%4E](7T-/35-43%])3DE424%,25-%4E-?4D5625-)3TX ,0T*



M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O


M("  ("  ("\O($EN8VQU9&4 =&AE($-/35-43"!R;V]T(&AE861E< T*(V5N

M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O

M("H 5&AE($-/35-43"!C;VUP;VYE;G1S(&%R92!C;VYT86EN960 =VET:&EN

M;B!A;&EA<R!F;W( <W1L<V]F=#HZ8V



M+2T ("  +2TM+2TM+2TM+2TM+2TM+2TM+2T ("  +2TM+2TM+2TM+2TM+2TM
M+2T-"B J("!N;W0 9&5F:6YE9"  ("  ("  ("  ("  ;F]T(&1E9FEN960 
M("  ("  ("  ("  /2!S=&QS;V9T.CIC;VUS=&Q?<')O:F5C= T*("H (&YO
M="!D969I;F5D("  ("  ("  ("  ("!D969I;F5D("  ("  ("  ("  ("  
M("!N;W0 9&5F:6YE9 T*("H (&1E9FEN960 ("  ("  ("  ("  ("  ("!N
M;W0 9&5F:6YE9"  ("  ("  ("  ("!C;VUS=&P-"B J("!D969I;F5D("  
M("  ("  ("  ("  ("  9&5F:6YE9"  ("  ("  ("  ("  ("  ;F]T(&1E

M10T*(R!I9F1E9B!?4U1,4T]&5%].3U].04U%4U!!0T4-"B\J(%1H97)E(&ES
M(&YO('-T;'-O9G0 ;F%M97-P86-E+"!S;R!M=7-T(&1E9FEN92 Z.F-O;7-T

M<W1L<V]F=#HZ8V]M<W1L7W!R;VIE8W0 *B\-" T*;F%M97-P86-E('-T;'-O



M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O


M(&ES('5S960 =&\ :6YI=&EA;&ES92!T:&4 0T]-(&QI8G)A<FEE<RX 270 

M;&%G<R!W:&5N('1R86YS;&%T960 :6X 82!$0T]-(&)U:6QD+ T*=&5M<&QA
M=&4\("  <W-?='EP96YA;65?<&%R86U?:R!)4"  +RH 26YI=&EA;&ES871I
M;VX <&]L:6-Y('1Y<&4 *B\-"B  ("  ("  +"  ('-S7W1Y<&5N86UE7W!A
M<F%M7VL 6%  ("\J($5X8V5P=&EO;B!P;VQI8WD ='EP92 J+PT*("  ("  

M9&5F(&EN:71I86QI<V5R("  8VQA<W-?='EP93L-"G!U8FQI8SH-"B  (" O
M+R\ 5&AE(&EN:71I86QI871I;VX <&]L:6-Y('1Y<&4-"B  ("!T>7!E9&5F
M($E0("  ("  ("  ("  ("  ("  ("  ("  ("  ("  ("  ("  ("  ("  

M+R\O(%1H92!E>&-E<'1I;VX ='EP90T*("  ('1Y<&5D968 6%  ("  ("  
M("  ("  ("  ("  ("  ("  ("  ("  ("  ("  ("  ("  ("  ("  ("  

M='EP90T*("  ('1Y<&5D968 <W-?='EP96YA;65?='EP95]K(&5X8V5P=&EO
M;E]P;VQI8WE?='EP93HZ=&AR;W=N7W1Y<&4 ("!T:')O=VY?='EP93L-" T*




M/B!F;&%G<PT*("  ('-S7V5X<&QI8VET7VL :6YI=&EA;&ES97(H8W-?9'=O



M?FEN:71I86QI<V5R*"D 8V]M<W1L7W1H<F]W7S H*3L-" T*+R\ 071T<FEB

M3TT ;&EB<F%R:65S('=E<F4 :6YI=&EA;&ES960-"B  ("!C<U]B;V]L7W0 
M:7-?:6YI=&EA;&ES960H*2!C;VYS=#L-"B  (" O+R\ 4F5F;&5C=', =VAE
M=&AE<B!T:&4 0T]-(&QI8G)A<FEE<R!W97)E(&YO="!I;FET:6%L:7-E9 T*

M92!R97-U;'0 ;V8 =&AE(&-A;&P =&\ 0V]);FET:6%L:7IE*"DO0V]);FET
M:6%L:7IE17 H*0T*("  ($A215-53%0 9V5T7TA215-53%0H*2!C;VYS=#L-
M" T*+R\ 365M8F5R<PT*<')I=F%T93H-"B  ("!(4D5354Q4(&-O;G-T("  


M8VQA<W-?='EP92!C;VYS=" F;W!E<F%T;W( /2AC;&%S<U]T>7!E(&-O;G-T
M("9R:',I.PT*?3L-" T*+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O







M4%!/4E0 *B\-"B  ("!S=&%T:6, =F]I9"!U;FEN:70H*0T*("  ('L-"B  

M="!/;&5);FET:6%L:7IE7W!O;&EC>0T*>PT*<'5B;&EC. T*("  ('-T871I
M8R!(4D5354Q4(&EN:70H*0T*("  ('L-"B  ("  ("  <F5T=7)N(#HZ3VQE


M("  ?0T*?3L-" T*+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O

M:71I86QI<V%T:6]N7V5X8V5P=&EO; T*>PT*<'5B;&EC. T*("  ("\O+R!4
M:&4 97AC97!T:6]N('1Y<&4-"B  ("!S=')U8W0 =&AR;W=N7W1Y<&4-"B  

M8V%L;"!O<&5R871O<BP =VAI8V  9&]E<R!N;W0 =&AR;W< 86X 97AC97!T

M:&%T(&-A=7-E9"!T:&4 97)R;W(-"B  (" O+R\ 7'!A<F%M(')I:60 5&AE
M(%)%1DE)1"!T:&%T(&-O=6QD(&YO="!B92!A8W%U:7)E9 T*("  ('9O:60 
M;W!E<F%T;W( *"DH2%)%4U5,5" O*B!H<B J+RP 4D5&24E$("\J<FEI9"HO


M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\O+PT*+R\ 5'EP961E9G, 9F]R(%53+45N9VQI<V  <W!E;&QE

M+"!I9VYO<F5?:6YI=&EA;&ES871I;VY?97AC97!T:6]N/B  (&-O;5]I;FET
M:6%L:7-E<CL-"G1Y<&5D968 :6YI=&EA;&ES97(\3VQE26YI=&EA;&EZ95]P
M;VQI8WDL(&EG;F]R95]I;FET:6%L:7-A=&EO;E]E>&-E<'1I;VX^("!O;&5?

M;FET:6%L:7IE<CL-"G1Y<&5D968 ;VQE7VEN:71I86QI<V5R(&]L95]I;FET
M:6%L:7IE<CL-" T*+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O
M+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O

M;7!L871E/"  ('-S7W1Y<&5N86UE7W!A<F%M7VL 25 -"B  ("  ("  +"  
M('-S7W1Y<&5N86UE7W!A<F%M7VL 6% -"B  ("  ("  / T*:6YL:6YE(&EN
M:71I86QI<V5R/$E0+"!84#XZ.FEN:71I86QI<V5R*"D-"B  (" Z(&U?:'(H


M7W1Y<&5N86UE7W!A<F%M7VL 25 -"B  ("  ("  +"  ('-S7W1Y<&5N86UE
M7W!A<F%M7VL 6% -"B  ("  ("  / T*:6YL:6YE(&EN:71I86QI<V5R/$E0
M+"!84#XZ.FEN:71I86QI<V5R*&-S7V1W;W)D7W0 8V]);FET*0T*("  (#H 
M;5]H<BAI;FET:6%L:7-A=&EO;E]P;VQI8WE?='EP93HZ:6YI="AC;TEN:70I

M=&5M<&QA=&4\("  <W-?='EP96YA;65?<&%R86U?:R!)4 T*("  ("  (" L

M:6YI=&EA;&ES97(\25 L(%A0/CHZ?FEN:71I86QI<V5R*"D 8V]M<W1L7W1H

M("  ("  ("!I;FET:6%L:7-A=&EO;E]P;VQI8WE?='EP93HZ=6YI;FET*"D[


M("  (#X-"FEN;&EN92!C<U]B;V]L7W0 :6YI=&EA;&ES97(\25 L(%A0/CHZ


M7VL 25 -"B  ("  ("  +"  ('-S7W1Y<&5N86UE7W!A<F%M7VL 6% -"B  
M("  ("  / T*:6YL:6YE(&-S7V)O;VQ?="!I;FET:6%L:7-E<CQ)4"P 6% ^
M.CIO<&5R871O<B A*"D 8V]N<W0-"GL-"B  ("!R971U<FX (6ES7VEN:71I

M7VL 25 -"B  ("  ("  +"  ('-S7W1Y<&5N86UE7W!A<F%M7VL 6% -"B  
M("  ("  / T*:6YL:6YE($A215-53%0 :6YI=&EA;&ES97(\25 L(%A0/CHZ
M9V5T7TA215-53%0H*2!C;VYS= T*>PT*("  (')E='5R;B!M7VAR.PT*?0T*









M:68 +RH (4-/35-43%])3D-,7TA?0T]-4U1,7TE.251)04Q)4T524R J+PT*

G+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R\O+R J+PT*
`
end