Função WPUGetProviderPath (ws2spi.h)

  • Artigo

A função WPUGetProviderPath recupera o caminho de DLL para o provedor especificado.

Sintaxe

int WPUGetProviderPath(
  [in]      LPGUID lpProviderId,
  [out]     WCHAR  *lpszProviderDllPath,
  [in, out] LPINT  lpProviderDllPathLen,
  [out]     LPINT  lpErrno
);

Parâmetros

[in] lpProviderId

Identificador local exclusivo do provedor. Esse deve ser um valor obtido usando WSCEnumProtocols.

[out] lpszProviderDllPath

Ponteiro para um buffer que contém uma cadeia de caracteres que identifica o caminho da DLL do provedor. Esse caminho é uma cadeia de caracteres terminada em nulo e todas as cadeias de caracteres de ambiente inseridas (como %SystemRoot%) não foram expandidas.

[in, out] lpProviderDllPathLen

Tamanho do buffer apontado por lpszProviderDllPath, em caracteres.

[out] lpErrno

Ponteiro para o código de erro.

Valor retornado

Se nenhum erro ocorrer, WPUGetProviderPath retornará zero. Caso contrário, ele retornará SOCKET_ERROR e um código de erro específico estará disponível em lpErrno.

Código do erro Significado
WSAEINVAL
 O parâmetro lpProviderId não especifica um provedor válido.
WSAEFAULT
 LpszProviderDllPath ou lpErrno não está em uma parte válida do espaço de endereço do usuário ou lpProviderDllPathLen é muito pequeno.
 
 

Comentários

A função WPUGetProviderPath recupera o caminho de DLL para o provedor especificado. O caminho de DLL é encerrado em nulo e pode conter cadeias de caracteres de ambiente inseridas (como %SystemRoot%). Portanto, a cadeia de caracteres deve ser expandida antes de ser usada com LoadLibrary. Para obter mais informações, consulte LoadLibrary.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ws2spi.h

Confira também

WSCEnumProtocols

WSCInstallProvider