Share via

3.1.4.2.6 put_OwnerSID (Opnum 12)

  • Article

The put_OwnerSID method sets the OwnerSID property of the event class.

 [propput, id(3), helpstring("property OwnerSID")] HRESULT OwnerSID(
   [in] BSTR bstrOwnerSID
 );

bstrOwnerSID: The OwnerSID property of the event class, as specified in section 3.1.1.1. The value MUST be specified in the Security Descriptor Description Language specified in [MS-DTYP] section 2.5.1.

Return Values: An HRESULT specifying success or failure. All success codes MUST be treated the same, and all failure codes MUST be treated the same.

When this method is invoked, the server MUST validate the new value of the property for syntax. If validation fails, the server MUST fail the method call. Otherwise, the server MUST attempt to update the state of the DCOM object servicing this method with the new value of the OwnerSID property, and fail the call, returning a failure HRESULT back to the client if it cannot. Otherwise, it MUST override any previous value that was set for this DCOM object instance servicing this method call.