Método IEnumCERTVIEWEXTENSION::GetName (certview.h)
El método GetName recupera el nombre de la extensión actual en la secuencia de enumeración de extensiones.
El nombre de extensión devuelto es una cadena de identificador de objeto (OID), como en L"2.5.29.31".
Sintaxis
HRESULT GetName(
[out] BSTR *pstrOut
);
Parámetros
[out] pstrOut
Puntero a un valor de tipo BSTR que contiene el nombre de la extensión.
Valor devuelto
C++
Si el método se ejecuta correctamente, el método devuelve S_OK y tat el parámetro pstrOut se establece en el nombre de la extensión.Para usar este método, cree una variable de tipo BSTR , establezca la variable igual a NULL y pase la dirección de esta variable como pstrOut. Cuando haya terminado de usar BSTR, ábrelo llamando a la función SysFreeString .
Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.
VB
El valor devuelto es una cadena que contiene el nombre de la extensión.Comentarios
Esta función se usa para recuperar el nombre de la extensión a la que hace referencia actualmente la secuencia de enumeración de extensiones.
Si la secuencia de enumeración de extensión no hace referencia a una extensión válida, se producirá un error en GetName . Use uno de los métodos siguientes para navegar por la enumeración :
- IEnumCERTVIEWEXTENSION::Reset: se mueve a la siguiente extensión de la secuencia de enumeración.
- IEnumCERTVIEWEXTENSION::Next: se mueve a la siguiente extensión de la secuencia de enumeración.
- IEnumCERTVIEWEXTENSION::Skip: omite un número especificado de extensiones.
Ejemplos
BSTR bstrExtName = NULL;
// pEnumExt is previously instantiated IEnumCERTVIEWEXTENSION object
hr = pEnumExt->GetName(&bstrExtName);
if (S_OK == hr)
printf("Extension name is: %ws\n", bstrExtName);
else
printf("GetName failed: %x\n", hr);
// free memory when done
if (NULL != bstrExtName)
SysFreeString(bstrExtName);
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | certview.h (incluya Certsrv.h) |
| Library | Certidl.lib |
| Archivo DLL | Certadm.dll |
Consulte también
IEnumCERTVIEWEXTENSION::GetFlags