CoGetPSClsid(3w)

CoGetPSClsid3w

Usage

HRESULT CoGetPSClsid
(
REFIID riid,
CLSID* pclsid
)

Overview

Retrieves the CLSID of the proxy/stub factory that implements IPSFactoryBuffer for the specified interface.

Params

riid [In] Interface whose proxy/stub CLSID is to be returned.

pclsid [Out] Where to store returned proxy/stub CLSID.

Returns

S_OK E_OUTOFMEMORY REGDB_E_IIDNOTREG if no PSFactoryBuffer is associated with the IID, or it could not be parsed.

Notes

The standard marshaller activates the object with the CLSID returned and uses the CreateProxy and CreateStub methods on its IPSFactoryBuffer interface to construct the proxies and stubs for a given object.

CoGetPSClsid determines this CLSID by searching the HKEY_CLASSES_ROOTInterface{string form of riid}ProxyStubClsid32 in the registry and any interface Id registered by CoRegisterPSClsid within the current process.

Implementation

Declared in "objbase.h".

Implemented in "dlls/ole32/compobj.c".

Debug channel "ole".

Releases

4 releases since Debian 4.0 (Etch); the text changed 3 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7

Bugs

Native returns S_OK for interfaces with a key in HKCRInterface, but without a ProxyStubClsid32 key and leaves garbage in pclsid. This should be considered a bug in native unless an application depends on this (unlikely).

From libwine-dev 1.4.1-4 in Debian 7 (Wheezy). Parsed by carta from the page's man source.