GetDestNameA

Anotações e ligações de área sensível, Destinos e ações

Descrição

O sufixo A indica o ponto de entrada ANSI (char) da DLL; a superfície ActiveX/COM expõe apenas a forma Unicode. O comportamento é idêntico ao de GetDestName e os argumentos de cadeia de caracteres são interpretados com base na página de código atual definida por SetAnsiMode

Devolve o nome de um identificador de destino designado ou uma matriz de destino explícita guardada na árvore de nomes do documento

Sintaxe

Delphi

Function DLGetDestNameA(InstanceID, DestID: Integer): PAnsiChar;

DLL

const char * DLGetDestNameA(int InstanceID, int DestID);

Parâmetros

DestIDIdentificador de destino devolvido por APIs como GetActionDest, GetOpenActionDestination ou GetNamedDestination

Valores devolvidos

empty stringO identificador não é um destino com nome e não foi encontrada nenhuma entrada correspondente na árvore de nomes
nameO nome do destino

Observações

Para matrizes de destino explícitas, a função pesquisa a árvore de nomes do documento e devolve o nome de destino correspondente, quando existir

Consulte também

GetOpenActionDestination, NewNamedDestination, SetOpenActionNamedDestination