Método IPart::GetName (devicetopology.h)
El método GetName obtiene el nombre descriptivo de esta parte.
Sintaxis
HRESULT GetName(
[out] LPWSTR *ppwstrName
);
Parámetros
[out] ppwstrName
Puntero a una variable de puntero en la que el método escribe la dirección de una cadena de caracteres anchos terminada en NULL que contiene el nombre descriptivo de esta parte. El método asigna el almacenamiento para la cadena. El autor de la llamada es responsable de liberar el almacenamiento, cuando ya no es necesario, llamando a la función CoTaskMemFree . Si se produce un error en la llamada a GetName , *ppwstrName es NULL. Para obtener información sobre CoTaskMemFree, consulte la documentación de Windows SDK.
Valor devuelto
Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.
| Código devuelto | Descripción |
|---|---|
|
El puntero ppwstrName es NULL. |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | devicetopology.h |