HRESULT WFPGetInfo( hService, dwCategory, lpQueryDetails, dwTimeOut, hWnd, ReqID )
Retrieves various kinds of information from the specified service provider.
Parameters HSERVICE hService
Handle to the service provider.
DWORD dwCategory
Specifies the category of the query (e.g., for a printer, WFS_INF_PTR_STATUS to request status or WFS_INF_PTR_CAPABILITIES to request capabilities). The available categories depend on the service class, the service provider and the service. The information requested can be either static or dynamic, e.g., basic service capabilities (static) or current service status (dynamic).
LPVOID lpQueryDetails
Pointer to the data structure to be passed to the service provider, containing further details to make the query more precise, e.g., a form name. (Many queries have no input parameters, in which case this pointer is NULL.)
DWORD dwTimeOut
Number of milliseconds to wait for completion (WFS_INDEFINITE_WAIT to specify a request that will wait until completion).
HWND hWnd
The window handle which is to receive the completion message for this request.
REQUESTID ReqID
Request identification number.
Mode Asynchronous
Comments The XFS Manager retrieves the information requested from the service provider itself, and, since the information can be stored remotely, the function cannot be guaranteed to complete immediately. Note that, typically, requests for generic and class specific categories can complete immediately. See WFSGetInfo for additional discussion.
The specifications for the information structures for each service class can be found in the specifications for the service-specific commmands.
Messages WFS_GETINFO_COMPLETE
Error Codes If the function return is not WFS_SUCCESS, it is one of the following error conditions, indicating that the asynchronous operation was not initiated. Any service-specific errors that can be returned are defined in the specifications for each service class.
The following error conditions are returned via the asynchronous command completion message, as the hResult from the WFSRESULT structure. Any service-specific errors that can be returned are defined in the specifications for each service class.