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
| DestID | Identificador de destino devolvido por APIs como GetActionDest, GetOpenActionDestination ou GetNamedDestination |
|---|
Valores devolvidos
| empty string | O identificador não é um destino com nome e não foi encontrada nenhuma entrada correspondente na árvore de nomes |
|---|---|
| name | O 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