IDXBindHost Interface

The IDXBindHost interface enables the container to specify which bind host to use, if your transform needs this service. The bind host is the interface supplied by the container that enables the client to open storage elements specified by a moniker (usually a URL moniker).

Implement this interface for transforms that need to be able to bind monikers. For example, the MetaStream transform uses this interface to obtain a base URL from their container. A container is responsible to query for this interface and to invoke its method if supported by the transform.

IDXBindHost Method

SetBindHost Specifies the bind host that the transform should use.

IDXBindHost::SetBindHost

IDXBindHost Interface

Specifies the bind host that the transform should use.

Syntax

HRESULT SetBindHost(
	IBindHost *pBindHost
);

Parameters

pBindHost
[in] Pointer to the bind host interface that the transform should use.

Return Value

Returns an HRESULT value that depends on the implementation of the interface.

Remarks

A call to SetBindHost with a NULL parameter must be allowed by transform objects. In response to a SetBindHost(NULL) call, the previously set bind host should be released and no longer used. It is not guaranteed that the bind host object will continue to exist, even if it is reference counted after this call on the transform object. Failure to properly implement this rule could cause transforms to fault when they release or are called through their IBindHost pointer. For more information, see a Component Object Model (COM) reference for the IBindHost interface.