Edit

Share via

pfnIsFileSupportedName callback function (mssip.h)

  • Article

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

Syntax

pfnIsFileSupportedName Pfnisfilesupportedname;

BOOL Pfnisfilesupportedname(
  [in]  WCHAR *pwszFileName,
  [out] GUID *pgSubject
)
{...}

Parameters

[in] pwszFileName

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

[out] pgSubject

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

SIPs must support a limited set of file types and file extensions. The fileSupportedName function must check that the provided file matches one of the file extensions supported by the SIP. For instance, the WSH SIP supports only the following list of file extensions and checks that the file under validation is a member of the following list: .js, .jse, .vbe, .vbs, or .wsf.

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

See also

pfnIsFileSupported