CERT_PHYSICAL_STORE_INFO構造体 (wincrypt.h)
CERT_PHYSICAL_STORE_INFO構造体には、物理証明書ストアに関する情報が含まれています。 これらの構造体の一部のメンバーは、物理ストアを開くために CertOpenStore のシステム呼び出しに直接渡されます。
構文
typedef struct _CERT_PHYSICAL_STORE_INFO {
DWORD cbSize;
LPSTR pszOpenStoreProvider;
DWORD dwOpenEncodingType;
DWORD dwOpenFlags;
CRYPT_DATA_BLOB OpenParameters;
DWORD dwFlags;
DWORD dwPriority;
} CERT_PHYSICAL_STORE_INFO, *PCERT_PHYSICAL_STORE_INFO;
メンバー
cbSize
この構造体のサイズ (バイト単位)。
pszOpenStoreProvider
証明書ストア プロバイダーの種類に名前を付ける文字列へのポインター。 この文字列は、 CertOpenStore へのシステム呼び出しで渡され、開く証明書ストアのプロバイダーの種類を決定します。 定義済みの証明書ストアの種類の名前については、「 CertOpenStore」を参照してください。
定義済みの証明書ストア プロバイダーの種類に加えて、新しいストア プロバイダーの種類をインストールし、 CryptInstallOIDFunctionAddress または CryptRegisterOIDFunction に登録できます。 詳細については、「 CertOpenStore」を参照してください。
dwOpenEncodingType
このメンバーは、 lpszStoreProvider でCERT_STORE_PROV_MSG、CERT_STORE_PROV_PKCS7、またはCERT_STORE_PROV_FILENAMEが渡された場合にのみ適用されます。 それ以外の場合、このメンバーは使用されません。
次の例に示すように、証明書と メッセージエンコードの両方の種類 をビットごとの OR 操作と組み合わせて指定することは、常に許容されます。
X509_ASN_ENCODING |PKCS_7_ASN_ENCODING 現在定義されているエンコードの種類は次のとおりです。
- X509_ASN_ENCODING
- PKCS_7_ASN_ENCODING
dwOpenFlags
システム ストアが SERVICES または USERS ストアの場所で開かれた場合、 dwOpenFlags ストアの 場所はCERT_SYSTEM_STORE_USERSまたはCERT_SYSTEM_STORE_SERVICESに設定されます。
OpenParameters
CertOpenStore 関数の pvPara パラメーターに渡されるデータを含むCRYPT_DATA_BLOB。 データ型は、指定されたプロバイダーによって異なります。 渡される種類とコンテンツの詳細については、「 CertOpenStore で使用可能なプロバイダーの説明」を参照してください。
dwFlags
CERT_PHYSICAL_STORE_INFOの dwFlags 値を次に示します。
| 値 | 意味 |
|---|---|
|
ストアへの コンテキスト への追加を有効にします。 |
|
CertRegisterPhysicalStore 関数によって設定されます。 既定では、レジストリ内にあるすべてのシステム ストアには、開かれた暗黙的な SystemRegistry 物理ストアがあります。 このストアのオープンを無効にするには、System ストアに対応する SystemRegistry 物理ストアを CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG 設定するか、 という名前の物理ストアを登録して登録する必要があります。Default" と CertRegisterPhysicalStore。 |
|
物理ストアのリモートオープンを無効にします。 |
|
他のプロバイダーの種類の前に文字列 \\ComputerName をPlacesします。 |
|
CertOpenStore で、定義済みの HKEY 定数の 1 つではなく、ユーザー指定の HKEY に対して相対的なストアを開くことができます。 たとえば、HKEY_CURRENT_USERはユーザー指定の HKEY に置き換えることができます。 CERT_SYSTEM_STORE_RELOCATE_FLAGが設定されている場合、CertOpenStore に渡される pvPara パラメーターは、null で終わる Unicode または ASCII 文字列としてストア名を指すのではなく、CERT_SYSTEM_STORE_RELOCATE_PARA構造体を指します。 |
dwPriority
システム ストアを開くと、その物理ストアは dwPriority 設定に従って順序付けられます。 dwPriority が高いほど、優先度が高いことを示します。 dwPriority メンバーは CertAddStoreToCollection に渡されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| Header | wincrypt.h |