SignerSignEx 関数
SignerSignEx 関数は、指定したファイルに署名し、署名されたデータへのポインターを返します。
Note
この関数には、ヘッダー ファイルまたはインポート ライブラリが関連付けされません。 この関数を呼び出すには、ユーザー定義ヘッダー ファイルを作成し、 LoadLibrary 関数と GetProcAddress 関数を使用して、Mssign32.dllに動的にリンクする必要があります。
構文
HRESULT WINAPI SignerSignEx(
_In_ DWORD dwFlags,
_In_ SIGNER_SUBJECT_INFO *pSubjectInfo,
_In_ SIGNER_CERT *pSignerCert,
_In_ SIGNER_SIGNATURE_INFO *pSignatureInfo,
_In_opt_ SIGNER_PROVIDER_INFO *pProviderInfo,
_In_opt_ LPCWSTR pwszHttpTimeStamp,
_In_opt_ PCRYPT_ATTRIBUTES psRequest,
_In_opt_ LPVOID pSipData,
_Out_ SIGNER_CONTEXT **ppSignerContext
);
パラメーター
-
dwFlags [in]
-
この関数の動作を変更します。
署名するファイルが移植可能な実行可能ファイル (PE) ファイルの場合、0 または次の値の 1 つ以上の組み合わせにすることができます。 これらの識別子は Mssip.h で定義されています。
値 説明 - SPC_EXC_PE_PAGE_HASHES_FLAG
- 0x10
PE ファイルの SIP 間接データを作成するときに、ページ ハッシュを除外します。 このフラグは 、SPC_INC_PE_PAGE_HASHES_FLAG フラグよりも優先されます。
SPC_EXC_PE_PAGE_HASHES_FLAGまたはSPC_INC_PE_PAGE_HASHES_FLAG フラグが指定されていない場合は、WintrustSetDefaultIncludePEPageHashes 関数で設定された値がこの設定に使用されます。 この設定の既定値は、PE ファイルの SIP 間接データを作成するときにページ ハッシュを除外することです。
Windows Server 2003 および Windows XP: この値はサポートされていません。- SPC_INC_PE_IMPORT_ADDR_TABLE_FLAG
- 0x20
この値はサポートされていません。 - SPC_INC_PE_DEBUG_INFO_FLAG
- 0x40
この値はサポートされていません。 - SPC_INC_PE_RESOURCES_FLAG
- 0x80
この値はサポートされていません。 - SPC_INC_PE_PAGE_HASHES_FLAG
- 0x100
PE ファイルの SIP 間接データを作成するときにページ ハッシュを含めます。
Windows Server 2003 および Windows XP: この値はサポートされていません。 -
pSubjectInfo [in]
-
署名するサブジェクトを指定する SIGNER_SUBJECT_INFO 構造体へのポインター。
-
pSignerCert [in]
-
デジタル署名の作成に使用する証明書を指定する SIGNER_CERT 構造体へのポインター。
-
pSignatureInfo [in]
-
デジタル署名に関する情報を含む SIGNER_SIGNATURE_INFO 構造体へのポインター。
-
pProviderInfo [in, optional]
-
デジタル 署名の作成 に使用される 暗号化サービス プロバイダー (CSP) と秘密キー情報を指定するSIGNER_PROVIDER_INFO構造体へのポインター。
このパラメーターの値が NULL の場合、 pSignerCert パラメーターの値は、CSP に関連付けられている証明書を指定する必要があります。
-
pwszHttpTimeStamp [in, optional]
-
タイム スタンプ サーバーの URL。
-
psRequest [in, optional]
-
署名要求に追加 されるCRYPT_ATTRIBUTE 構造体の配列へのポインター。 pwszHttpTimeStamp パラメーターに NULL ではない有効な値が含まれていない場合、このパラメーターは無視されます。
-
pSipData [in, optional]
-
SIP 関数に追加データとして渡される 32 ビット値。 この形式と内容は、SIP プロバイダーによって定義されます。
-
ppSignerContext [out]
-
署名付き BLOB を含むSIGNER_CONTEXT構造体へのポインターのアドレス。 SIGNER_CONTEXT構造体の使用が完了したら、SignerFreeSignerContext 関数を呼び出してSIGNER_CONTEXT構造体を解放します。
戻り値
関数が成功した場合、関数はS_OKを返します。
関数が失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
[DLL] |
|
関連項目