CallUDF

Область применения: Excel 2013 | Office 2013 | Visual Studio

Вызывает определяемую пользователем функцию в высокопроизводительной вычислительной среде.

int CallUDF(int SessionId, WCHAR *XllName, WCHAR *UDFName, LPXLOPER12 pxAsyncHandle, int (*CallBackAddr)(), int ArgCount, LPXLOPER12 Parameter1, ...)

Параметры

Sessionid

Идентификатор сеанса, в котором выполняется вызов.

XLLName

Имя XLL, содержащего определяемую пользователем функцию.

UDFName

Имя определяемой пользователем функции.

CallBackAddr

Функция, которую соединитель должен вызывать по завершении определяемой пользователем функции.

pxAsyncHandle

Асинхронный дескриптор, используемый Excel и соединителем для отслеживания ожидающего вызова определяемой пользователем функции. Соединитель использует его позже при завершении вызова, когда он вызывает обратно в Excel с помощью указателя функции, переданного в аргументе CallBackAddr .

ArgCount

Количество аргументов для передачи в определяемую пользователем функцию. Максимально допустимое значение — 255.

Параметр1

Значение, передаваемое в определяемую пользователем функцию. Повторите этот аргумент для каждого параметра, указанного argCount.

Возвращаемое значение

xlHpcRetSuccess, если вызов UDF успешно инициирован; xlHpcRetInvalidSessionId , если аргумент SessionId недопустим; xlHpcRetCallFailed при других сбоях, включая время ожидания. Если вызов возвращает любой код ошибки (любой код, кроме xlHpcRetSuccess), то Excel считает вызов UDF сбоем, делает pxAsyncHandle недействительным и не ожидает обратного вызова.

Замечания

Эта функция выполняется асинхронно.

См. также

• Функции для работы с соединителями кластеров Excel