Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
Область применения: Excel 2013 | Office 2013 | Visual Studio
Функции библиотеки платформы. Excel — это оболочка для функции Excel4 . Excel12f — это оболочка для функции Excel12 . Каждый проверяет, что ни один из аргументов не равен нулю, что указывает на то, что создание временного XLOPER или XLOPER12 завершилось сбоем. При возникновении ошибки каждый из них выводит сообщение отладки. По завершении каждый из них освобождает всю временную память, которая могла быть создана для временных XLOPERs и XLOPER12s.
Excel12f можно вызывать только из библиотеки DLL, начиная с библиотеки API C Excel 2007. Кроме того, он работает только при запуске, начиная с Excel 2007, а в противном случае — с ошибкой xlretFailed .
int Excel(int iFunction, LPXLOPER pxRes, int iCount,
LPXLOPER argument1, ...);
int Excel12f(int iFunction, LPXLOPER12 pxRes, int iCount,
LPXLOPER12 argument1, ...);
Параметры
iFunction (int)
Число, указывающее команду или функцию, которую требуется вызвать. Дополнительные сведения см. в статье Excel4/Excel12.
pxRes
Указатель на результат вычисляемой функции. Любая память, на которую указывает результат, будет выделена Excel и должна быть освобождена при вызове xlFree , когда она больше не нужна, или путем установки xlbitXLFree , если она возвращается в Excel.
iCount (int)
Число аргументов, которые будут переданы функции. Начиная с Excel 2007, ограничение составляет 255 аргументов. В более ранних версиях ограничение равно 30.
argument1, ...
Необязательные аргументы функции. Все аргументы должны быть указателями на XLOPERs в случае Excel или XLOPER12в случае Excel12f.
Возвращаемое значение
Обе функции возвращают те же коды ошибок и успешного выполнения, что и Excel4, Excel4v, Excel12 и Excel12v. Полное описание этих кодов см. в статье Excel4/Excel12 . Кроме того, эти функции платформы возвращают xlretFailed без вызова API C при обнаружении указателя NULL на параметр.
Пример
В этом примере в функцию Excel12f передается недопустимый аргумент, который отправляет сообщение в отладчик.
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI Excel12fExample(void)
{
Excel12f(xlcDisplay, 0, 1, 0);
return 1;
}