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 値を次に示します。

意味
CERT_PHYSICAL_STORE_ADD_ENABLE_FLAG
ストアへの コンテキスト への追加を有効にします。
CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG
CertRegisterPhysicalStore 関数によって設定されます。 既定では、レジストリ内にあるすべてのシステム ストアには、開かれた暗黙的な SystemRegistry 物理ストアがあります。 このストアのオープンを無効にするには、System ストアに対応する SystemRegistry 物理ストアを CERT_PHYSICAL_STORE_OPEN_DISABLE_FLAG 設定するか、 という名前の物理ストアを登録して登録する必要があります。Default" と CertRegisterPhysicalStore
CERT_PHYSICAL_STORE_REMOTE_OPEN_DISABLE_FLAG
物理ストアのリモートオープンを無効にします。
CERT_PHYSICAL_STORE_INSERT_COMPUTER_NAME_ENABLE_FLAG
他のプロバイダーの種類の前に文字列 \\ComputerName をPlacesします。
CERT_SYSTEM_STORE_RELOCATE_FLAG
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

こちらもご覧ください

CertAddStoreToCollection

CertOpenStore

CertRegisterPhysicalStore

CryptInstallOIDFunctionAddress

CryptRegisterOIDFunction