Share via

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