The GetComponentInfo method is used to determine the environment of the server object.
HRESULT GetComponentInfo( [in, out] int* infoMask, [out] SAFEARRAY(BSTR)* infoArray );
infoMask: A bitwise OR of zero of more of the following values:
|
Value |
Meaning |
|---|---|
|
0x00000001 |
The serviced component's process identifier (PID). |
|
0x00000002 |
The serviced component's application domain identifier (ID). |
|
0x00000004 |
The serviced component's remote URI [RFC3986], which represents the server object identity. |
On input, the bits set indicate the information the client is requesting that the server return. On output, the bits set indicate the information actually returned in the infoArray.
infoArray: An array that contains a set of values returned by the server corresponding to the bits set in infoMask.
Return Values: An HRESULT that specifies success or failure. All success HRESULT values MUST be treated as success and all failure HRESULT values MUST be treated as failure.
When this method is invoked, the server MUST do the following. If any bits not defined above in infoMask are set, the server first MUST update infoMask to clear those bits.
The server MUST return in infoArray a SAFEARRAY ([MS-OAUT] section 2.2.30.10) of type VT_BSTR. This SAFEARRAY MUST contain, in order, the (possibly empty) subset of the following items, corresponding to the bits set in infoMask.
Process ID
Application Domain ID
The serviced component's remote URI [RFC3986]
The type of each element MUST be a BSTR ([MS-OAUT] section 2.2.23.2). The server then MUST return success.