Compartir a través de

Ix509CertificateTemplateWritable::Commit (certenroll.h)

  • Artículo

El método Commit elimina una plantilla de o la guarda en Active Directory.

Sintaxis

HRESULT Commit(
  [in] CommitTemplateFlags commitFlags,
  [in] BSTR                strServerContext
);

Parámetros

[in] commitFlags

Valor de enumeración CommitTemplateFlags que especifica cómo guardar o eliminar la plantilla. Debe ser uno de los siguientes valores.

Valor Significado
CommitFlagSaveTemplateGenerateOID
 Guarde la plantilla y cree un identificador de objeto para ella.
CommitFlagSaveTemplateUseCurrentOID
 No se usa.
CommitFlagSaveTemplateOverwrite
 No se usa.
CommitFlagDeleteTemplate
 Elimine la plantilla.

[in] strServerContext

Variable BSTR que contiene el nombre DNS del servidor de Active Directory al que se aplicarán los cambios. Si este valor es NULL, los cambios se aplicarán al controlador de dominio predeterminado.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Código devuelto Descripción
CRYPT_E_EXISTS
 CommitFlagSaveTemplateGenerateOID se especificó en el argumento commitFlags , pero ya existe una plantilla con un nombre común coincidente o un identificador de objeto coincidente (OID).
CRYPT_E_NOT_FOUND
 CommitFlagDelete se especificó en el argumento commitFlags y se encontró una plantilla con el mismo nombre común, pero el OID no coincidía.
E_ACCESSDEINED
 El autor de la llamada no tiene el permiso adecuado para guardar o eliminar una plantilla. El autor de la llamada debe tener permiso de escritura y eliminación en el contenedor de plantillas y los objetos de plantilla en Active Directory. Si el autor de la llamada tiene permiso de eliminación en el contenedor de plantillas y los objetos, pero no tiene permiso de eliminación en el contenedor de OID y los objetos, la plantilla se eliminará, pero el OID no lo será.
E_NOTIMPL
 CommitFlagSaveTemplateUseCurrentOID o CommitFlagSaveTemplateOverwrite se especificó en el argumento commitFlags. Estos valores no se usan actualmente.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 CommitFlagDelete se especificó en el argumento commitFlags, pero no se encontró una plantilla que tenga un nombre común (CN) coincidente.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 El método Commit no se admite para las plantillas predeterminadas.
OLE_E_BLANK
 El objeto IX509CertificateTemplateWritable no se ha inicializado.

Comentarios

Cuando CommitFlagSaveTemplateGenerateOID se especifica en el argumento commitFlags , este método no se realizará correctamente a menos que ya se hayan creado los contenedores de plantilla y OID. Estos contenedores se pueden crear de cualquiera de las maneras siguientes:

  • Instalación de una entidad de certificación empresarial en el servidor.
  • Iniciar el complemento Certtmpl.msc.
  • Con el comandoCertutil.exe -installDefaultTemplates para instalar las plantillas predeterminadas.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certenroll.h

Consulte también

IX509CertificateTemplateWritable