Método IEnumCERTVIEWCOLUMN::GetName (certview.h)
El método GetName recupera el nombre no localizado de la columna actual en la secuencia de enumeración de columnas.
Sintaxis
HRESULT GetName(
[out] BSTR *pstrOut
);
Parámetros
[out] pstrOut
Puntero a una variable de tipo BSTR que contiene el nombre de la columna.
Valor devuelto
C++
Si el método se realiza correctamente, el método devuelve S_OK y el parámetro pstrOut contiene el nombre de la columna.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 el BSTR, áurelo 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 columna.Comentarios
Este método se usa para recuperar el nombre no localizado de la columna a la que hace referencia actualmente la secuencia de enumeración de columnas.
Si la secuencia de enumeración de columnas no hace referencia a una columna válida, Se producirá un error en GetName . Use uno de los métodos siguientes para navegar por la enumeración :
- IEnumCERTVIEWCOLUMN::Reset: se mueve al principio de la secuencia de enumeración.
- IEnumCERTVIEWCOLUMN::Next: se mueve a la siguiente columna de la secuencia de enumeración.
- IEnumCERTVIEWCOLUMN::Skip: omite un número especificado de columnas.
Ejemplos
BSTR bstrColName = NULL;
HRESULT hr;
// pEnumCol is previously instantiated IEnumCERTVIEWCOLUMN object
hr = pEnumCol->GetName(&bstrColName);
if (S_OK == hr)
printf("Column name is %ws\n", bstrColName);
// done processing, clear resources
if (NULL != bstrColName)
SysFreeString(bstrColName);
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 (incluye Certsrv.h) |
| Library | Certidl.lib |
| Archivo DLL | Certadm.dll |