Método ICertServerPolicy::SetCertificateProperty (certif.h)

Artigo
02/23/2024

Use o método SetCertificateProperty para definir uma propriedade associada a um certificado.

Sintaxe

HRESULT SetCertificateProperty(
  [in] const BSTR    strPropertyName,
  [in] LONG          PropertyType,
  [in] const VARIANT *pvarPropertyValue
);

Parâmetros

[in] strPropertyName

Especifica a propriedade a ser definida. Você pode definir qualquer uma das Propriedades de Nome associadas ao certificado.

Além disso, você pode definir as propriedades do certificado a seguir.

Valor	Significado
Notbefore Data/hora	O certificado não é válido antes da data especificada.
NotAfter Data/hora	O certificado não é válido após a data especificada.
GeneralFlags	Defina essa propriedade como 0x00000400 para impedir que a solicitação seja mantida no banco de dados da AC. Cuidado Não substitua nenhum valor de máscara retornado por GetCertificateProperty ao definir essa propriedade. Defina o valor executando um OR bit a bit com os valores existentes. Windows Storage Server 2003: Não há suporte para esse campo.
CrossForest PROPTYPE_LONG	Um valor booliano que especifica se a AC deve operar o modo de registro entre florestas. Windows Server 2008 e Windows Server 2003: Não há suporte para o registro entre florestas. O registro entre florestas tem suporte a partir do Windows Server 2008 R2.
RequesterSAMName PROPTYPE_STRING	Informa à AC para definir o nome da conta do solicitante ("RequesterName") e o nome diferenciado.
RequesterUPN PROPTYPE_STRING	Informa à AC para converter o NOME UPN do solicitante para o nome do solicitante ("RequesterName") e definir o nome do solicitante e o nome diferenciado do solicitante.
RequesterDN PROPTYPE_STRING	Informa à AC para converter o nome FQDN 1779 do solicitante para o nome do solicitante e definir o nome do solicitante ("RequesterName") e o nome diferenciado do solicitante.

[in] PropertyType

Especifica o tipo da propriedade que está sendo definida. O parâmetro Type deve concordar com o tipo de dados de pvarValue definido no campo vt da estrutura VARIANT . O parâmetro Type pode ser definido como um dos tipos a seguir.

Valor	Significado
PROPTYPE_LONG	Dados longos assinados.
PROPTYPE_DATE	Dados de data/hora.
PROPTYPE_BINARY	Dados binários.
PROPTYPE_STRING	Dados de cadeia de caracteres Unicode

[in] pvarPropertyValue

Especifica o valor para o qual definir a propriedade.

Retornar valor

VB

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

Você deve chamar ICertServerPolicy::SetContext antes de usar esse método.

As propriedades do certificado NotBefore e NotAfter restringem o tempo de vida durante o qual um certificado é válido. O tipo de dados para essas propriedades é uma data VARIANT de ponto flutuante derivada de COleDateTime na Automação.

As seguintes restrições se aplicam ao definir as propriedades de certificado NotBefore e NotAfter com SetCertificateProperty:

A data NotBefore não pode ser definida como uma data anterior à data NotBefore do certificado da AC (autoridade de certificação ).
A data NotAfter não pode ser definida como uma data posterior à data NotAfter do certificado da AC.
A data NotBefore não pode ser definida como uma data anterior à que já está definida, mesmo que a nova data seja posterior à data NotBefore do certificado da AC.
A data NotAfter não pode ser definida como uma data posterior à que já está definida, mesmo que a nova data seja anterior à data NotAfter do certificado da AC.

Exemplos

O exemplo a seguir chama o método SetCertificateProperty para definir a propriedade de certificado NotBefore. O exemplo pressupõe que pServer é válido e o método ICertServerPolicy::SetContext foi chamado.

HRESULT hr;
ICertServerPolicy *pServer;
SYSTEMTIME st;
BSTR bstrPropName;
VARIANT vPropValue;

bstrPropName = SysAllocString(L"NotBefore");
if (NULL == bstrPropName)
{
    printf("Unable to allocate memory.\n"); 
    return E_OUTOFMEMORY;
}

// Set the 'NotBefore' property to Noon on Jan. 1, 2000.
memset( &st, 0, sizeof(SYSTEMTIME));
st.wYear = 2000;
st.wMonth = 1;     // Jan.
st.wDay = 1;       // 1st day of month.
st.wHour = 12;     // Noon.

// Place the date into VARIANT required format.
VariantInit( &vPropValue );
vPropValue.vt = VT_DATE;
if ( !SystemTimeToVariantTime( &st, &vPropValue.date))
{
    printf("Unable to convert time.\n");
    SysFreeString(bstrPropName);
    return E_FAIL
}

// Set the NotBefore property in the certificate:
hr = pServer->SetCertificateProperty(bstrPropName,
                                     PROPTYPE_DATE, 
                                     &vPropValue);
SysFreeString(bstrPropName);
VariantClear(&vPropValue);
if (FAILED(hr))
{
    printf("SetCertificateProperty failed [%x]\n", hr);
    return hr;
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certif.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certcli.dll