Função WSCGetProviderPath32 (ws2spi.h)
A função WSCGetProviderPath32 recupera o caminho de DLL para o provedor de 32 bits especificado.
Sintaxe
int WSCGetProviderPath32(
[in] LPGUID lpProviderId,
[out] WCHAR *lpszProviderDllPath,
[in, out] LPINT lpProviderDllPathLen,
[out] LPINT lpErrno
);
Parâmetros
[in] lpProviderId
Identificador local exclusivo do provedor. Esse valor é obtido usando WSCEnumProtocols32.
[out] lpszProviderDllPath
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
Tamanho do buffer apontado pelo parâmetro lpszProviderDllPath , em caracteres.
[out] lpErrno
Ponteiro para o código de erro.
Valor retornado
Se nenhum erro ocorrer, WSCGetProviderPath32 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 |
|---|---|
| O parâmetro lpProviderId não especifica um provedor válido. | |
| 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
WSCGetProviderPath32 é uma versão estritamente de 32 bits do WSCGetProviderPath. Em um computador de 64 bits, todas as chamadas não são especificamente de 32 bits (por exemplo, todas as funções que não terminam em "32") operam no catálogo nativo de 64 bits. Os processos executados em um computador de 64 bits devem usar as chamadas de função específicas de 32 bits para operar em um catálogo estritamente de 32 bits e preservar a compatibilidade. As definições e a semântica das chamadas específicas de 32 bits são as mesmas que suas contrapartes nativas.
A função WSCGetProviderPath32 recupera o caminho da 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
| Cliente mínimo com suporte | Windows Vista, Windows XP Professional x64 Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2008, Windows Server 2003 x64 Edition [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ws2spi.h |
| Biblioteca | Ws2_32.lib |
| DLL | Ws2_32.dll |