Função WSCGetProviderPath (ws2spi.h)

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.

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

Confira também

WSCEnumProtocols

WSCInstallProvider