CertSetStoreProperty-Funktion (wincrypt.h)

Die CertSetStoreProperty-Funktion legt eine Speichereigenschaft fest.

Syntax

BOOL CertSetStoreProperty(
  [in] HCERTSTORE hCertStore,
  [in] DWORD      dwPropId,
  [in] DWORD      dwFlags,
  [in] const void *pvData
);

Parameter

[in] hCertStore

Handle für den Zertifikatspeicher.

[in] dwPropId

Gibt eine aus einem Bereich von Speichereigenschaften an. Werte für benutzerdefinierte Eigenschaften müssen außerhalb des aktuellen Bereichs vordefinierter Kontexteigenschaftenwerte liegen. Derzeit beginnen benutzerdefinierte dwPropId-Werte bei 4.096. Es gibt eine vordefinierte Speichereigenschaft, CERT_STORE_LOCALIZED_NAME_PROP_ID, den lokalisierten Namen des Speichers.

[in] dwFlags

Für die zukünftige Verwendung reserviert und muss null sein.

[in] pvData

Die Typdefinition für pvData hängt vom dwPropId-Wert ab. Wenn dwPropId CERT_STORE_LOCALIZED_NAME_PROP_ID ist, verweist pvData auf eine CRYPT_DATA_BLOB-Struktur . Der pbData-Member dieser Struktur ist ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Endung. Das cbData-Element dieser Struktur ist ein DWORD-Wert , der die Länge der Zeichenfolge enthält.

Für benutzerdefinierte dwPropId-Werte ist pvData ein Zeiger auf eine codierte CRYPT_DATA_BLOB.

Wenn bereits ein Wert für die ausgewählte Eigenschaft vorhanden ist, wird der alte Wert ersetzt.

Durch aufrufen dieser Funktion, bei der pvData auf NULL festgelegt ist, wird eine -Eigenschaft gelöscht.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE.

Hinweise

Store-Eigenschaftsbezeichner sind Eigenschaften, die für einen gesamten Speicher gelten. Sie sind keine Eigenschaften für ein einzelnes Zertifikat, eine CRL oder einen CTL-Kontext . Derzeit werden keine Speichereigenschaften beibehalten.

Beispiele

Das folgende Beispiel zeigt das Festlegen der lokalisierten Namenseigenschaft eines geöffneten Zertifikatspeichers.

//--------------------------------------------------------------
// Declare and initialize variables.

HCERTSTORE hCertStore = NULL;       // Original certificate store
CRYPT_DATA_BLOB Property_Name_Blob; // BLOB to hold store property

//--------------------------------------------------------------
// Open the certificate store that will have its localized name
// property set. In this case, the CA system store is opened. 

if ( hCertStore = CertOpenStore(
    CERT_STORE_PROV_SYSTEM,
    0,
    NULL,
    CERT_SYSTEM_STORE_CURRENT_USER,
    L"CA"))
{
     printf("The CA store is open.\n");
}
else
{
     printf("The CA store could not be opened \n.");
     exit(1);
}

//--------------------------------------------------------------------
// Prepare a data structure to set a store property.
// Initialize the members of the CRYPT_DATA_BLOB.
Property_Name_Blob.pbData = (BYTE *) L"The Local CA Store";
Property_Name_Blob.cbData = 
       (wcslen((LPWSTR)Property_Name_Blob.pbData)+1) * sizeof(WCHAR);

//--------------------------------------------------------------------
// Set the store's localized name property.
if (CertSetStoreProperty(
    hCertStore,
    CERT_STORE_LOCALIZED_NAME_PROP_ID,
    0,
    &Property_Name_Blob))
{
     printf("The name of the store has been set. Continue. \n");
}
else
{
     printf("Setting the store's localized name failed.\n");
     exit(1);
}

// Close the store when done.
if (!CertCloseStore(
     hCertStore,
     0 ))
{
     printf("The CA store could not be closed \n.");
     exit(1);

}

Ein weiteres Beispiel, das diese Funktion verwendet, finden Sie unter Beispiel-C-Programm: Festlegen und Abrufen von Zertifikatspeichereigenschaften.

Anforderungen

Weitere Informationen

CertGetStoreProperty

Zertifikatspeicherfunktionen