Función GetServiceKeyNameA (winsvc.h)

Recupera el nombre del servicio especificado.

Sintaxis

BOOL GetServiceKeyNameA(
  [in]            SC_HANDLE hSCManager,
  [in]            LPCSTR    lpDisplayName,
  [out, optional] LPSTR     lpServiceName,
  [in, out]       LPDWORD   lpcchBuffer
);

Parámetros

[in] hSCManager

Identificador de la base de datos del administrador de control de servicios del equipo, tal y como devuelve OpenSCManager.

[in] lpDisplayName

Nombre para mostrar del servicio. Esta cadena tiene una longitud máxima de 256 caracteres.

[out, optional] lpServiceName

Puntero a un búfer que recibe el nombre del servicio. Si se produce un error en la función, este búfer contendrá una cadena vacía.

El tamaño máximo de esta matriz es de 4 000 bytes. Para determinar el tamaño necesario, especifique NULL para este parámetro y 0 para el parámetro lpcchBuffer. Se producirá un error en la función y GetLastError devolverá ERROR_INSUFFICIENT_BUFFER. El parámetro lpcchBuffer recibirá el tamaño necesario.

[in, out] lpcchBuffer

Puntero a variable que especifica el tamaño del búfer al que apunta el parámetro lpServiceName, en TCHAR. Cuando la función devuelve, este parámetro contiene el tamaño del nombre del servicio, en TCHAR, excluyendo el carácter de terminación NULL.

Si el búfer al que apunta lpServiceName es demasiado pequeño para contener el nombre del servicio, la función no almacena ningún dato en él. Cuando se devuelve la función, lpcchBuffer contiene el tamaño del nombre del servicio, excepto el terminador NULL.

Valor devuelto

Si las funciones se realizan correctamente, el valor devuelto es distinto de cero.

Si se produce un error en la función, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Observaciones

Hay dos nombres para un servicio: el nombre del servicio y el nombre para mostrar. El nombre del servicio es el nombre de la clave del servicio en el Registro. El nombre para mostrar es un nombre descriptivo que aparece en la aplicación del panel de control Servicios y se usa con el comando NET START. Ambos nombres se especifican con la función CreateService y se pueden modificar con la función ChangeServiceConfig. La información especificada para un servicio se almacena en una clave con el mismo nombre que el nombre del servicio en la clave del Registro HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\ServiceName.

Para asignar el nombre del servicio al nombre para mostrar, use la función GetServiceDisplayName. Para asignar el nombre para mostrar al nombre del servicio, use la función getServiceKeyName .

Nota

El encabezado winsvc.h define GetServiceKeyName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winsvc.h (incluya Windows.h)
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll

Consulte también

GetServiceDisplayName

OpenSCManager

Funciones de servicio