Função NdisCoGetTapiCallId (ndis.h)
NdisCoGetTapiCallId recupera uma cadeia de caracteres que os aplicativos TAPI podem usar para identificar uma vc (conexão virtual) NDIS específica.
Sintaxe
NDIS_STATUS NdisCoGetTapiCallId(
[in] NDIS_HANDLE NdisVcHandle,
[in, out] PVAR_STRING TapiCallId
);
Parâmetros
[in] NdisVcHandle
Especifica o identificador NDIS para a VC. Esse identificador foi fornecido pelo NDIS quando a VC foi originalmente criada com a função NdisCoCreateVc.
[in, out] TapiCallId
Ponteiro para um buffer alocado por chamador que recebe uma estrutura de dados do tipo VAR_STRING. Após o retorno bem-sucedido, essa estrutura descreve uma cadeia de caracteres que os aplicativos TAPI podem usar para identificar a VC.
Valor de retorno
Retorna um dos seguintes valores de status:
| Código de retorno | Descrição |
|---|---|
|
O NDIS retornou com êxito um identificador de cadeia de caracteres para a VC. |
|
O ulTotalSize membro da estrutura VAR_STRING especifica que o tamanho do buffer não é grande o suficiente para manter a cadeia de caracteres que identifica a VC. NdisCoGetTapiCallId define o membro ulNeededSize da estrutura VAR_STRING para o tamanho necessário em bytes. |
|
O identificador para a VC especificado por NdisVcHandle não é válido. |
Observações
Suponha que um gerenciador de chamadas chame NdisCoCreateVc para criar uma VC para uma chamada TAPI. O NDIS, por sua vez, fornece o identificador para a VC para um cliente. O cliente passa esse identificador vc em uma chamada para a função NdisCoGetTapiCallId para recuperar uma cadeia de caracteres que identifica a VC. O cliente pode passar esse identificador de cadeia de caracteres para um aplicativo TAPI para identificar a VC.
O cliente cria um contexto para cada VC que gerencia. O cliente usa NdisCoGetTapiCallId para recuperar um identificador de cadeia de caracteres para cada VC. O cliente passa cada identificador de cadeia de caracteres para um aplicativo TAPI para identificar cada VC. Posteriormente, se um aplicativo TAPI passar um desses identificadores de cadeia de caracteres para o cliente em uma operação relacionada a VC, o cliente deverá passar esse identificador de cadeia de caracteres como uma cadeia de caracteres Unicode em uma chamada para NdisClGetProtocolVcContextFromTapiCallId para recuperar o contexto correto para a VC.
Para obter mais informações sobre a estrutura de VAR_STRING, consulte de objetos TAPI.