This topic has not yet been rated - Rate this topic

pfnIsFileSupportedName function pointer

Applies to: desktop apps only

The pfnIsFileSupportedName callback function queries the subject interface packages (SIPs) listed in the registry to determine which SIP handles the file type.

Syntax

typedef BOOL ( WINAPI *pfnIsFileSupportedName)(
  __in   WCHAR *pwszFileName,
  __out  GUID *pgSubject
);

Parameters

pwszFileName [in]

A pointer to a null-terminated string that contains the absolute path to the file to be processed by the SIP.

pgSubject [out]

The GUID identifying the SIP that handles the file type.

Return value

The return value is TRUE if the function succeeds; FALSE if the function fails. If the function fails, call the GetLastError function to determine the reason for failure.

Remarks

If the SIP supports the file type passed by hfile, the function returns TRUE, and sets pgSubject to the GUID that identifies the SIP for handling the file type.

Each SIP implements its own version of the function that determines if the file type is supported. The specific name of the function may vary depending on the implementation of the SIP, but the signature of the function will match that of the pfnIsFileSupportedName function. The function name is added to the registry by the CryptSIPAddProvider function, which takes the function name as parameter in the pwszIsFunctionNameFmt2 field in the SIP_ADD_NEWPROVIDER structure.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Mssip.h

See also

pfnIsFileSupported

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ