BindIFilterFromStorage function

[Indexing Service is unsupported as of Windows XP. Instead, use Windows Search for client side search and Microsoft Search Server Express for server side search.]

Retrieves the IFilter interface pointer for the specified storage object. This is especially useful when filtering the contents of a document and processing embedded OLE objects that are accessible through their IStorage interfaces.

Syntax


HRESULT __stdcall BindIFilterFromStorage(
  _In_  IStorage *pStg,
  _In_  IUnknown *pUnkOuter,
  _Out_ void     **ppIUnk
);

Parameters

pStg [in]

A pointer to the IStorage interface to be used to access the file.

pUnkOuter [in]

A pointer to the controlling IUnknown interface of the aggregate in which this storage object exists.

ppIUnk [out]

A pointer to an output variable that receives the IFilter interface pointer.

Return value

This function can return one of these values.

Return codeDescription
S_OK

The operation was completed successfully.

E_ACCESSDENIED

The function was denied access to the path of the storage object.

E_HANDLE

The function encountered an invalid handle, probably due to a low-memory situation.

E_INVALIDARG

The function received an invalid parameter.

E_OUTOFMEMORY

The function did not have sufficient memory or other resources to complete the operation.

E_FAIL

An unknown error has occurred.

 

Remarks

This function is not a full implementation of a COM persistent handler.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Ntquery.h

Library

Ntquery.lib

DLL

Ntquery.dll

See also

BindIFilterFromStream
IFilter
LoadIFilter

 

 

Show: