pfnIsFileSupported callback function (mssip.h)

Article
02/22/2024

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

Syntax

pfnIsFileSupported Pfnisfilesupported;

BOOL Pfnisfilesupported(
  [in]  HANDLE hFile,
  [out] GUID *pgSubject
)
{...}

Parameters

[in] hFile

A handle to the file.

[out] pgSubject

The GUID that identifies the SIP that handles the file type.

Return value

If the function succeeds, the function returns TRUE.

If the function fails, it returns FALSE. For extended error information, call GetLastError.

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 whether 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 SIP_ADD_NEWPROVIDER structure.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	mssip.h

Share via