Excel/Excel12f
Aplica-se a: Excel 2013 | Office 2013 | Visual Studio
Funções da biblioteca de estruturas. O Excel é um wrapper para a função Excel4 . O Excel12f é um wrapper para a função Excel12 . Cada verifica se nenhum dos argumentos é zero, o que indica que a criação de um XLOPER temporário ou XLOPER12 falhou. Se ocorrer um erro, cada um imprimirá uma mensagem de depuração. Quando concluído, cada um libera toda a memória temporária que pode ter sido criada para XLOPERs e XLOPER12temporários.
O Excel12f só pode ser chamado de uma DLL começando com a biblioteca de API C do Excel 2007. Além disso, ele só funciona ao executar a partir do Excel 2007 e falha com xlretFailed caso contrário.
int Excel(int iFunction, LPXLOPER pxRes, int iCount,
LPXLOPER argument1, ...);
int Excel12f(int iFunction, LPXLOPER12 pxRes, int iCount,
LPXLOPER12 argument1, ...);
Parâmetros
iFunction (int)
Um número que indica o comando ou a função que você deseja chamar. Para obter mais informações, consulte Excel4/Excel12.
pxRes
Um ponteiro para o resultado da função avaliada. Qualquer memória apontada no resultado terá sido alocada pelo Excel e deverá ser liberada em uma chamada para xlFree depois que ela não for mais necessária ou definindo xlbitXLFree se a retornar ao Excel.
iCount (int)
O número de argumentos que serão passados para a função. A partir do Excel 2007, o limite é de 255 argumentos. Em versões anteriores, o limite é 30.
argument1, ...
Os argumentos opcionais para a função. Todos os argumentos devem ser ponteiros para XLOPERs no caso do Excel ou XLOPER12s no caso do Excel12f.
Valor de retorno
Ambas as funções retornam os mesmos códigos de erro e êxito que Excel4, Excel4v, Excel12 e Excel12v. Consulte Excel4/Excel12 para obter uma descrição completa desses códigos. Além disso, essas funções framework retornam xlretFailed sem chamar a API C se um ponteiro NULL para um parâmetro for detectado.
Exemplo
Este exemplo passa um argumento incorreto para a função Excel12f , que envia uma mensagem para o depurador.
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI Excel12fExample(void)
{
Excel12f(xlcDisplay, 0, 1, 0);
return 1;
}