pfnIsFileSupportedName 回呼函式 (mssip.h)

pfnIsFileSupportedName 回呼函式會查詢登錄中列出的主體介面套件 (SIP) ，以判斷哪一個 SIP 會處理檔類型。

語法

pfnIsFileSupportedName Pfnisfilesupportedname;

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

[in] pwszFileName

Null 終止字串的指標，其中包含 SIP 所要處理之檔案的絕對路徑。

[out] pgSubject

識別處理檔類型之 SIP 的 GUID。

如果函式成功，則傳回值為 TRUE ; 如果函式失敗，則為 FALSE。如果函式失敗，請呼叫 GetLastError 函式來判斷失敗的原因。

如果 SIP 支援 hfile 傳遞的檔案類型，此函式會傳回 TRUE，並將 pgSubject 設定為 GUID，以識別 SIP 來處理檔類型。

每個 SIP 都會實作自己的函式版本，以判斷是否支援檔類型。函式的特定名稱可能會因 SIP 的實作而有所不同，但函式的簽章會符合 SIP_ADD_NEWPROVIDER 結構的簽章。

SIP 必須支援一組有限的檔案類型和擴展名。 fileSupportedName 函式必須檢查提供的檔案是否符合 SIP 支援的其中一個擴展名。例如，WSH SIP 僅支援下列擴展名清單，並檢查正在驗證的檔案是否為下列清單的成員：.js、.jse、.vbe、.vbs 或 .wsf。