Compartilhar via


xlfSetName

Aplica-se a: Excel 2013 | Office 2013 | Visual Studio

Usado para criar e excluir nomes definidos associados à DLL.

Excel12(xlfSetName, LPXLOPER12 pxRes, 2, LPXLOPER12 pxNameText, LPXLOPER12 pxNameDefinition);

Parâmetros

pxNameText (xltypeStr)

O nome do intervalo, que deve estar em conformidade com as limitações usuais no Microsoft Excel em nomes válidos.

pxNameDefinition (xltypeStr, xltypeNum, xltypeBool, xltypeErr, xltypeMulti, xltypeSRef, xltypeRef ou xltypeInt)

(Opcional). O valor, conjunto de valores, célula ou intervalo de células que pxNameText é definido como. Se omitido, o nome será excluído.

Valor de propriedade/Valor de retorno

pxRes (xltypeBool ou xltypeErr)

TRUE se a operação tiver sido bem-sucedida ou FALSE se o nome não puder ser criado ou excluído. Retorna #VALUE! se um ou mais argumentos eram inválidos.

Comentários

Quando uma função ou comando é registrado usando xlfRegister com um argumento pxFunctionText válido, o Excel cria um nome associado ao recurso DLL. Quando a DLL estiver sendo descarregada, esses nomes devem ser excluídos usando a função xlfSetName. No entanto, devido a um problema conhecido no Excel, essa operação de exclusão falha. Confira mais informações em Problemas conhecidos no desenvolvimento de XLL do Excel.

Exemplo

Consulte o código da função xlAutoClose em \SAMPLES\GENERIC\GENERIC.C.

Confira também