2.2.22.2.5 ActivationContextInfoData

  • Article

The ActivationContextInfoData structure passes a client context and optionally a prototype context to the server as part of an activation request.

CLSID_ActivationContextInfo (see section 1.9) is used to identify this property in the CustomHeader.pclsid array.

 typedef struct tagActivationContextInfoData {
   long clientOK;
   long bReserved1;
   DWORD dwReserved1;
   DWORD dwReserved2;
   MInterfacePointer* pIFDClientCtx;
   MInterfacePointer* pIFDPrototypeCtx;
 } ActivationContextInfoData;

clientOK: This MUST be set to FALSE (0x00000000) and MUST be ignored on receipt.

bReserved1: This MUST be set to FALSE (0x00000000) and MUST be ignored on receipt.

dwReserved1: This MUST be set to zero and MUST be ignored on receipt.

dwReserved2: This MUST be set to zero and MUST be ignored on receipt.

pIFDClientCtx: This MUST contain an OBJREF specifying a marshaled client context as specified in section 2.2.20. The server MUST return RPC_E_INVALID_OBJREF (as specified in [MS-ERREF] section 2.1) if the OBJREF is NULL or invalid.

pIFDPrototypeCtx: If an application or a higher-layer protocol instructs the client to send prototype context properties, this MUST contain an OBJREF specifying a marshaled prototype context as specified in section 2.2.20. Otherwise, this MUST be set to NULL.