Compartilhar via

Função WSCGetProviderPath (ws2spi.h)

  • Artigo

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

Sintaxe

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

Parâmetros

[in] lpProviderId

Um ponteiro para um GUID (identificador global exclusivo) para o provedor. Esse valor é obtido usando WSCEnumProtocols.

[out] lpszProviderDllPath

Um ponteiro para um buffer no qual a cadeia de caracteres de caminho da DLL do provedor é retornada. O caminho é uma cadeia de caracteres terminada em nulo e as cadeias de caracteres de ambiente inseridas, como %SystemRoot%, não foram expandidas.

[in, out] lpProviderDllPathLen

O tamanho, em caracteres, do buffer apontado pelo parâmetro lpszProviderDllPath .

[out] lpErrno

Um ponteiro para o código de erro se a função falhar.

Retornar valor

Se nenhum erro ocorrer, WSCGetProviderPath retornará zero. Caso contrário, ele retornará SOCKET_ERROR. O código de erro específico está disponível em lpErrno.

Código do erro Significado
WSAEINVAL
 O parâmetro lpProviderId não especifica um provedor válido.
WSAEFAULT
 O parâmetro 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 WSCGetProviderPath recupera o caminho de DLL para o provedor especificado. O caminho da DLL pode conter cadeias de caracteres de ambiente inseridas, como %SystemRoot%, e, portanto, deve ser expandido antes de ser usado com a função LoadLibrary do Windows. Para obter mais informações, consulte LoadLibrary.

Requisitos

Requisito Valor
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
Biblioteca Ws2_32.lib
DLL Ws2_32.dll

Confira também

WSCEnumProtocols

WSCInstallProvider