Función CertSetStoreProperty (wincrypt.h)

La función CertSetStoreProperty establece una propiedad de almacén.

Sintaxis

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

Parámetros

[in] hCertStore

Identificador del almacén de certificados.

[in] dwPropId

Indica uno de los intervalos de propiedades de almacén. Los valores de las propiedades definidas por el usuario deben estar fuera del intervalo actual de valores de propiedad de contexto predefinidos. Actualmente, los valores dwPropId definidos por el usuario comienzan en 4096. Hay una propiedad de almacén predefinida, CERT_STORE_LOCALIZED_NAME_PROP_ID, el nombre localizado del almacén.

[in] dwFlags

Reservado para uso futuro y debe ser cero.

[in] pvData

La definición de tipo para pvData depende del valor dwPropId . Si dwPropId es CERT_STORE_LOCALIZED_NAME_PROP_ID, pvData apunta a una estructura de CRYPT_DATA_BLOB . El miembro pbData de esa estructura es un puntero a una cadena de caracteres Unicode terminada en null. El miembro cbData de esa estructura es un valor DWORD que contiene la longitud de la cadena.

Para los valores dwPropId definidos por el usuario, pvData es un puntero a un CRYPT_DATA_BLOB codificado.

Si ya existe un valor para la propiedad seleccionada, se reemplaza el valor anterior.

Al llamar a esta función con pvData establecido en NULL , se elimina una propiedad .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE.

Comentarios

Los identificadores de propiedad de la tienda son propiedades aplicables a un almacén completo. No son propiedades para un certificado individual, CRL o contexto de CTL . Actualmente, no se conservan propiedades de almacén.

Ejemplos

En el ejemplo siguiente se muestra cómo establecer la propiedad de nombre localizada de un almacén de certificados abierto.

//--------------------------------------------------------------
// 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);

}

Para obtener otro ejemplo que usa esta función, vea Programa C de ejemplo: Establecer y obtener propiedades del almacén de certificados.

Requisitos

Cliente mínimo compatible	Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincrypt.h
Library	Crypt32.lib
Archivo DLL	Crypt32.dll

Consulte también

CertGetStoreProperty

Funciones del almacén de certificados