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

IX509EnrollmentPolicyServer

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID13b79026-2181-11da-b2a4-000e7bbb2b09継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 24

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

vtbl 7 HRESULT Initialize(LPWSTR bstrPolicyServerUrl, LPWSTR bstrPolicyServerId, X509EnrollmentAuthFlags authFlags, VARIANT_BOOL fIsUnTrusted, X509CertificateEnrollmentContext context)
bstrPolicyServerUrlLPWSTRin登録ポリシーサーバー(CEP)の URL を文字列で指定する。
bstrPolicyServerIdLPWSTRinポリシーサーバーを一意に識別する ID を文字列で指定する。
authFlagsX509EnrollmentAuthFlagsinポリシーサーバーへの接続に用いる認証方式を指定する X509EnrollmentAuthFlags 列挙値である。
fIsUnTrustedVARIANT_BOOLinポリシーサーバーが信頼されていないサーバーとして扱われるかどうかを VARIANT_BOOL で指定する。
contextX509CertificateEnrollmentContextin登録コンテキスト(ユーザー/マシン/管理者)を指定する X509CertificateEnrollmentContext 列挙値である。
vtbl 8 HRESULT LoadPolicy(X509EnrollmentPolicyLoadOption option)
optionX509EnrollmentPolicyLoadOptioninポリシー情報をキャッシュから読み込むかサーバーから再取得するか等を指定する X509EnrollmentPolicyLoadOption 列挙値である。
vtbl 9 HRESULT GetTemplates(IX509CertificateTemplates** pTemplates)
pTemplatesIX509CertificateTemplates**outポリシーサーバーから取得した証明書テンプレートのコレクション IX509CertificateTemplates を受け取るポインタである。
vtbl 10 HRESULT GetCAsForTemplate(IX509CertificateTemplate* pTemplate, ICertificationAuthorities** ppCAs)
pTemplateIX509CertificateTemplate*inoptional対象とする証明書テンプレートを表す IX509CertificateTemplate オブジェクトを渡す。
ppCAsICertificationAuthorities**out指定テンプレートに対して登録可能な認証局のコレクション ICertificationAuthorities を受け取るポインタである。
vtbl 11 HRESULT GetCAs(ICertificationAuthorities** ppCAs)
ppCAsICertificationAuthorities**outポリシーサーバーが提供する認証局のコレクション ICertificationAuthorities を受け取るポインタである。
vtbl 12 HRESULT Validate()
vtbl 13 HRESULT GetCustomOids(IObjectIds** ppObjectIds)
ppObjectIdsIObjectIds**outポリシーサーバーが定義するカスタム OID のコレクション IObjectIds を受け取るポインタである。
vtbl 14 HRESULT GetNextUpdateTime(DOUBLE* pDate)
pDateDOUBLE*outポリシー情報の次回更新予定日時を OLE オートメーション日付(DOUBLE)として受け取るポインタである。
vtbl 15 HRESULT GetLastUpdateTime(DOUBLE* pDate)
pDateDOUBLE*outポリシー情報が最後に更新された日時を OLE オートメーション日付(DOUBLE)として受け取るポインタである。
vtbl 16 HRESULT GetPolicyServerUrl(LPWSTR* pValue)
pValueLPWSTR*outポリシーサーバーの URL を文字列として受け取るポインタである。
vtbl 17 HRESULT GetPolicyServerId(LPWSTR* pValue)
pValueLPWSTR*outポリシーサーバーの ID を文字列として受け取るポインタである。
vtbl 18 HRESULT GetFriendlyName(LPWSTR* pValue)
pValueLPWSTR*outポリシーサーバーの表示名(フレンドリ名)を文字列として受け取るポインタである。
vtbl 19 HRESULT GetIsDefaultCEP(VARIANT_BOOL* pValue)
pValueVARIANT_BOOL*outこのサーバーが既定の登録ポリシーサーバー(CEP)かどうかを表す VARIANT_BOOL を受け取るポインタである。
vtbl 20 HRESULT GetUseClientId(VARIANT_BOOL* pValue)
pValueVARIANT_BOOL*outクライアント ID を使用するかどうかを表す VARIANT_BOOL を受け取るポインタである。
vtbl 21 HRESULT GetAllowUnTrustedCA(VARIANT_BOOL* pValue)
pValueVARIANT_BOOL*out信頼されていない CA を許可するかどうかを表す VARIANT_BOOL を受け取るポインタである。
vtbl 22 HRESULT GetCachePath(LPWSTR* pValue)
pValueLPWSTR*outポリシーキャッシュファイルのパスを文字列として受け取るポインタである。
vtbl 23 HRESULT GetCacheDir(LPWSTR* pValue)
pValueLPWSTR*outポリシーキャッシュを格納するディレクトリのパスを文字列として受け取るポインタである。
vtbl 24 HRESULT GetAuthFlags(X509EnrollmentAuthFlags* pValue)
pValueX509EnrollmentAuthFlags*outポリシーサーバーへの接続に使用される認証方式を表す X509EnrollmentAuthFlags 値を受け取るポインタである。
vtbl 25 HRESULT SetCredential(INT hWndParent, X509EnrollmentAuthFlags flag, LPWSTR strCredential, LPWSTR strPassword)
hWndParentINTin資格情報入力 UI を表示する際の親ウィンドウハンドルを INT として指定する。
flagX509EnrollmentAuthFlagsin設定する資格情報の認証方式を指定する X509EnrollmentAuthFlags 列挙値である。
strCredentialLPWSTRin認証に用いるユーザー名等の資格情報を文字列で指定する。
strPasswordLPWSTRin認証に用いるパスワードを文字列で指定する。
vtbl 26 HRESULT QueryChanges(VARIANT_BOOL* pValue)
pValueVARIANT_BOOL*outサーバー上のポリシーに変更があったかどうかを表す VARIANT_BOOL を受け取るポインタである。
vtbl 27 HRESULT InitializeImport(VARIANT val)
valVARIANTinエクスポートされたポリシー情報を VARIANT として渡し、これを基にオブジェクトを初期化する。
vtbl 28 HRESULT Export(X509EnrollmentPolicyExportFlags exportFlags, VARIANT* pVal)
exportFlagsX509EnrollmentPolicyExportFlagsinエクスポートに含める情報の範囲を指定する X509EnrollmentPolicyExportFlags 列挙値である。
pValVARIANT*outエクスポートされたポリシー情報を VARIANT として受け取るポインタである。
vtbl 29 HRESULT get_Cost(DWORD* pValue)
pValueDWORD*outポリシーサーバーへのアクセスコスト(優先順位)を表す DWORD を受け取るポインタである。
vtbl 30 HRESULT put_Cost(DWORD value)
valueDWORDinポリシーサーバーへのアクセスコスト(優先順位)を DWORD で指定する。

HSP用 COM定義

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

出力引数:
#define global IID_IX509EnrollmentPolicyServer "{13B79026-2181-11DA-B2A4-000E7BBB2B09}"
#usecom global IX509EnrollmentPolicyServer IID_IX509EnrollmentPolicyServer "{}"
#comfunc global IX509EnrollmentPolicyServer_Initialize           7 wstr,wstr,int,int,int
#comfunc global IX509EnrollmentPolicyServer_LoadPolicy           8 int
#comfunc global IX509EnrollmentPolicyServer_GetTemplates         9 sptr
#comfunc global IX509EnrollmentPolicyServer_GetCAsForTemplate    10 sptr,sptr
#comfunc global IX509EnrollmentPolicyServer_GetCAs               11 sptr
#comfunc global IX509EnrollmentPolicyServer_Validate             12
#comfunc global IX509EnrollmentPolicyServer_GetCustomOids        13 sptr
#comfunc global IX509EnrollmentPolicyServer_GetNextUpdateTime    14 var
#comfunc global IX509EnrollmentPolicyServer_GetLastUpdateTime    15 var
#comfunc global IX509EnrollmentPolicyServer_GetPolicyServerUrl   16 var
#comfunc global IX509EnrollmentPolicyServer_GetPolicyServerId    17 var
#comfunc global IX509EnrollmentPolicyServer_GetFriendlyName      18 var
#comfunc global IX509EnrollmentPolicyServer_GetIsDefaultCEP      19 var
#comfunc global IX509EnrollmentPolicyServer_GetUseClientId       20 var
#comfunc global IX509EnrollmentPolicyServer_GetAllowUnTrustedCA  21 var
#comfunc global IX509EnrollmentPolicyServer_GetCachePath         22 var
#comfunc global IX509EnrollmentPolicyServer_GetCacheDir          23 var
#comfunc global IX509EnrollmentPolicyServer_GetAuthFlags         24 var
#comfunc global IX509EnrollmentPolicyServer_SetCredential        25 int,int,wstr,wstr
#comfunc global IX509EnrollmentPolicyServer_QueryChanges         26 var
#comfunc global IX509EnrollmentPolicyServer_InitializeImport     27 int
#comfunc global IX509EnrollmentPolicyServer_Export               28 int,var
#comfunc global IX509EnrollmentPolicyServer_get_Cost             29 var
#comfunc global IX509EnrollmentPolicyServer_put_Cost             30 int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。