WSCInstallProvider
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função instala o provedor especificado transporte em banco de dados configuração de sistema.
Syntax
int WSCInstallProvider(
const LPGUID lpProviderId,
const LPWSTR lpszProviderDllPath,
const LPWSAPROTOCOL_INFOW lpProtocolInfoList,
DWORD dwNumberOfEntries,
LPINT lpErrno
);
Parameters
- lpProviderId
[no] Ponteiro para uma Provider-Selected, identificador exclusivo (GUID).
- lpszProviderDllPath
[no] Ponteiro para uma seqüência de caracteres que contém o caminho carregar para o provedor é DLL. Esta seqüência de caracteres observa as regras comuns para resolução caminho e pode conter incorporado seqüências ambiente (como % systemroot %). Tais seqüências ambiente são expandidas sempre que o ws2.dll subseqüentemente precisa carregar o provedor DLL on Behalf Of um aplicativo. Após qualquer incorporado ambiente seqüências são expandidas, o ws2.dll passa a seqüência de caracteres resultante para o LoadLibrary função para carregar o provedor na memória. Para obter mais informações, consulte LoadLibrary.
- lpProtocolInfoList
[no] Aponta para uma matriz de WSAPROTOCOL_INFOW estruturas. Cada estrutura define um protocolo, address_family e socket_type com suporte, o provedor.
- dwNumberOfEntries
[no] Contém o número de entradas na lpProtocolInfoList matriz.
- lpErrno
[out] Ponteiro para o código de erro.
Return Value
Se não houver erro, essa função retornará zero. Caso contrário, ele retorna SOCKET_ERROR e um código de erro específico está disponível em lpErrno.
A seguinte tabela mostra a código de erro possíveis.
| Valor de erro | Descrição |
|---|---|
WSAEFAULT |
Um ou mais do argumentsis não EM UM válido parte espaço de endereço o usuário. |
WSANO_RECOVERY |
Aplicativo do chamador não é privilegiado. |
Remarks
Essa rotina cria o comum necessária informações configuração sockets do Windows (Winsock) para o provedor especificado. É aplicável para protocolos de base, em camadas os protocolos e provedor cadeias. Após essa rotina seja concluído com êxito, as protocolo informações fornecidas no lpProtocolInfoList Será retornado pela WSAEnumProtocols. Observe que em ambientes Win32, somente instâncias do ws2.dll criados após um bem-sucedido conclusão desta função incluirá as novas entradas no WSAEnumProtocols.
Qualquer arquivo instalação ou configuração service_provider-specific deve ser executada, o chamador.
Requirements
| Header | ws2spi.h |
| Library | Ws2.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |