Win32 API 日本語リファレンス
ホーム › Security.Cryptography › IMSCEPSetup

IMSCEPSetup

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID4f7761bb-9f3b-4592-9ee0-9a73259c313e継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

証明書サービスコンピューター上に Network Device Enrollment Service (NDES) ロールをインストールおよびアンインストールする機能を定義します。

メソッド 12

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_MSCEPErrorId(INT* pVal)

失敗した Network Device Enrollment Service (NDES) の指定に関する追加のエラー情報の ID を取得します。親オブジェクトに対して何らかのメソッドを呼び出すと、このプロパティはリセットされます。

pValINT*out直近の操作で発生したエラーの ID を受け取る INT へのポインタである。
vtbl 8 HRESULT get_MSCEPErrorString(LPWSTR* pVal)

失敗した Network Device Enrollment Service (NDES) の指定に関する追加のエラー情報の文字列データを保持します。親オブジェクトに対して何らかのメソッドを呼び出すと、このプロパティはリセットされます。

pValLPWSTR*out直近の操作で発生したエラーの説明文字列を受け取る LPWSTR へのポインタである。
vtbl 9 HRESULT InitializeDefaults()

Network Device Enrollment Service (NDES) ロールのインストールを可能にするため、CMSCEPSetup オブジェクトを既定値で初期化します。

vtbl 10 HRESULT GetMSCEPSetupProperty(MSCEPSetupProperty propertyId, VARIANT* pVal)

Network Device Enrollment Service (NDES) の構成に関するプロパティ値を取得します。

propertyIdMSCEPSetupPropertyin取得するプロパティの種類を指定する MSCEPSetupProperty 列挙型の値。
pValVARIANT*outプロパティ値を指定する VARIANT。VARIANT の型はプロパティの種類によって異なります。VARIANT の型の詳細については、MSCEPSetupProperty を参照してください。
vtbl 11 HRESULT SetMSCEPSetupProperty(MSCEPSetupProperty propertyId, VARIANT* pPropertyValue)

Network Device Enrollment Service (NDES) の構成に関するプロパティ値を設定します。

propertyIdMSCEPSetupPropertyin構成するプロパティの種類を指定する MSCEPSetupProperty 列挙型の値。
pPropertyValueVARIANT*inプロパティ値を指定する VARIANT へのポインター。VARIANT の型はプロパティの種類によって異なります。VARIANT の型の詳細については、MSCEPSetupProperty を参照してください。
vtbl 12 HRESULT SetAccountInformation(LPWSTR bstrUserName, LPWSTR bstrPassword)

ネットワークデバイスに代わって登録を実行するために IIS の Network Device Enrollment Service (NDES) 拡張機能が使用するユーザーアカウント情報を設定します。

bstrUserNameLPWSTRinIIS 拡張機能で使用するユーザーアカウントの名前を [DomainName]UserName の形式で格納した文字列。
bstrPasswordLPWSTRinユーザーアカウントのパスワードを格納した文字列。

解説(Remarks)

このアカウントは、コンピューター上の IIS_USRS グループのメンバーである必要があります。

NDES がエンタープライズ 証明機関 (CA) 用に構成されている場合、このアカウントは IPSecIntermediateOffline テンプレートに対する読み取り権限を持っている必要があります。

vtbl 13 HRESULT IsMSCEPStoreEmpty(VARIANT_BOOL* pbEmpty)

常に VARIANT_TRUE を返します。使用しないでください。

pbEmptyVARIANT_BOOL*outこのパラメーターには常に VARIANT_TRUE が格納されます。

解説(Remarks)

Network Device Enrollment Service (NDES) ロールでは、My 個人ストアが使用されます。既定の実装では、署名用証明書と交換用証明書に別々のストアを使用しません。

vtbl 14 HRESULT GetProviderNameList(VARIANT_BOOL bExchange, VARIANT* pVal)

コンピューター上で非対称鍵の署名アルゴリズムおよび交換アルゴリズムを提供する暗号化サービスプロバイダー (CSP) の一覧を取得します。

bExchangeVARIANT_BOOLinプロバイダー名が交換鍵アルゴリズム用かどうかを示す値。VARIANT_TRUE の場合は交換鍵のプロバイダーを示し、それ以外の場合は署名鍵のプロバイダーを示します。
pValVARIANT*outVT_BSTR 型の VARIANT 配列へのポインター。各文字列は CSP の名前を表します。
vtbl 15 HRESULT GetKeyLengthList(VARIANT_BOOL bExchange, LPWSTR bstrProviderName, VARIANT* pVal)

指定した暗号化サービスプロバイダー (CSP) がサポートする鍵長の一覧を取得します。(IMSCEPSetup.GetKeyLengthList)

bExchangeVARIANT_BOOLin列挙される鍵長が交換鍵アルゴリズム用かどうかを示す値。VARIANT_TRUE の場合は交換鍵の鍵長を示し、それ以外の場合は署名鍵の鍵長を示します。
bstrProviderNameLPWSTRinCSP の名前を格納した文字列。
pValVARIANT*outCSP がサポートする鍵長に対応する VT_UI4 型の VARIANT 配列へのポインター。
vtbl 16 HRESULT Install()

CMSCEPSetup オブジェクトで構成された内容に従って、Network Device Enrollment Service (NDES) ロールをインストールします。

vtbl 17 HRESULT PreUnInstall()

Network Device Enrollment Service (NDES) ロールのレジストリ設定および IIS 設定を削除します。

解説(Remarks)

このメソッドは、NDES ロールのアンインストールをサポートするために使用できます。対象のロールが既にコンピューターにインストールされている必要があります。このメソッドは、ロール固有のコンポーネントベースサービス (CBS) のアンインストール処理を呼び出す前に呼び出してください。

vtbl 18 HRESULT PostUnInstall()

実装されていません。将来の使用のために予約されています。

戻り値

このメソッドは値を返しません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数: 
#define global IID_IMSCEPSetup "{4F7761BB-9F3B-4592-9EE0-9A73259C313E}"
#usecom global IMSCEPSetup IID_IMSCEPSetup "{}"
#comfunc global IMSCEPSetup_get_MSCEPErrorId       7 var
#comfunc global IMSCEPSetup_get_MSCEPErrorString   8 var
#comfunc global IMSCEPSetup_InitializeDefaults     9
#comfunc global IMSCEPSetup_GetMSCEPSetupProperty  10 int,var
#comfunc global IMSCEPSetup_SetMSCEPSetupProperty  11 int,var
#comfunc global IMSCEPSetup_SetAccountInformation  12 wstr,wstr
#comfunc global IMSCEPSetup_IsMSCEPStoreEmpty      13 var
#comfunc global IMSCEPSetup_GetProviderNameList    14 int,var
#comfunc global IMSCEPSetup_GetKeyLengthList       15 int,wstr,var
#comfunc global IMSCEPSetup_Install                16
#comfunc global IMSCEPSetup_PreUnInstall           17
#comfunc global IMSCEPSetup_PostUnInstall          18
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。