Função WSCGetProviderPath32 (ws2spi.h)

  • Artigo

A função WSCGetProviderPath32 recupera o caminho de DLL para o provedor de 32 bits especificado.

Nota Essa chamada é uma versão estritamente de 32 bits do WSCGetProviderPath para uso em plataformas de 64 bits. Ele é fornecido para permitir que processos de 64 bits acessem os catálogos de 32 bits.

 

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
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

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

Confira também

WSCEnumProtocols32

WSCInstallProvider64_32