CryptSIPRetrieveSubjectGuidForCatalogFile 関数 (mssip.h)

  • [アーティクル]

CryptSIPRetrieveSubjectGuidForCatalogFile 関数は、指定されたファイルに関連付けられているサブジェクト GUID を取得します。

構文

BOOL CryptSIPRetrieveSubjectGuidForCatalogFile(
  [in]           LPCWSTR FileName,
  [in, optional] HANDLE  hFileIn,
  [out]          GUID    *pgSubject
);

パラメーター

[in] FileName

ファイルの名前です。 hFileIn パラメーターが設定されている場合、このパラメーターの値は無視されます。

[in, optional] hFileIn

チェックするファイルへのハンドル。 FileName パラメーターが NULL の場合、このパラメーターには有効なハンドルが含まれている必要があります。

[out] pgSubject

サブジェクトを識別するグローバルに一意の ID。

戻り値

関数が成功した場合、戻り値は TRUE です。それ以外の場合は FALSE。

この関数が FALSE を返す場合は、 GetLastError 関数を呼び出すことで追加のエラー情報を取得できます。 GetLastError は、次のいずれかのエラー コードを返します。

リターン コード 説明
ERROR_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。

注釈

この関数は、ポータブル実行可能イメージ (.exe)、キャビネット (.cab) イメージ、フラット ファイルに使用される サブジェクト インターフェイス パッケージ (SID) のみをサポートします。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー mssip.h
Library Crypt32.lib
[DLL] Crypt32.dll