Función WNetGetProviderNameA (winnetwk.h)

La función WNetGetProviderName obtiene el nombre del proveedor para un tipo específico de red.

Sintaxis

DWORD WNetGetProviderNameA(
  [in]      DWORD   dwNetType,
  [out]     LPSTR   lpProviderName,
  [in, out] LPDWORD lpBufferSize
);

Parámetros

[in] dwNetType

Tipo de red que es único para la red. Si dos redes reclaman el mismo tipo, la función devuelve el nombre del proveedor cargado primero. Solo se usa la palabra alta del tipo de red. Si una red notifica un subtipo en la palabra baja, se omite.

Puede encontrar una lista completa de los tipos de red en el archivo de encabezado Winnetwk.h.

[out] lpProviderName

Puntero a un búfer que recibe el nombre del proveedor de red.

[in, out] lpBufferSize

Tamaño del búfer pasado a la función, en caracteres. Si el valor devuelto es ERROR_MORE_DATA, lpBufferSize devuelve el tamaño de búfer necesario (en caracteres) para contener el nombre del proveedor.

Windows Me/98/95: El tamaño del búfer está en bytes, no en caracteres. Además, el búfer debe tener al menos 1 byte de longitud.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si se produce un error en la función, el valor devuelto es un código de error del sistema , como uno de los valores siguientes.

Código devuelto	Descripción
ERROR_MORE_DATA	El búfer es demasiado pequeño para contener el nombre del proveedor de red.
ERROR_NO_NETWORK	La red no está disponible.
ERROR_INVALID_ADDRESS	El parámetro lpProviderName o el parámetro lpBufferSize no es válido.

Observaciones

Nota

El encabezado winnetwk.h define WNetGetProviderName 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 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winnetwk.h
biblioteca de	Mpr.lib
DLL de	Mpr.dll

Consulte también

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

redes de Windows (WNet)

funciones de red de Windows