Excel/Excel12f
適用対象: Excel 2013 | Office 2013 | Visual Studio
フレームワーク ライブラリ関数。 Excel は Excel4 関数のラッパーです。 Excel12f は Excel12 関数のラッパーです。 引数がいずれも 0 になっていないことをそれぞれ確認します。0 の場合は一時的な XLOPER や XLOPER12 が作成できなかったことを表します。 エラーが発生すると、それぞれデバッグ メッセージが出力されます。 出力が終わると、一時的な XLOPER や XLOPER12 用に作成された一時メモリはすべて解放されます。
Excel12f は、Excel 2007 C API ライブラリ以降の DLL からのみ呼び出すことができます。 さらに、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 を呼び出して解放するか、または Excel に戻す場合は xlbitXLFree を設定して解放します。
iCount (int)
関数に渡される引数の数。 Excel 2007 以降では、制限は 255 個の引数です。 それ以前のバージョンの制限値は 30 です。
argument1, ...
省略可能な、関数の引数。 すべての引数は、Excel の場合は XLOPER へのポインター、Excel12f の場合は XLOPER12 へのポインターにする必要があります。
戻り値
どちらの関数も、Excel4、Excel4v、Excel12、Excel12v と同様のエラー コードや成功コードを返します。 これらのコードの詳細については、「Excel4/Excel12」を参照してください。 さらに、パラメーターに対する NULL ポインターが検出された場合、これらのフレームワーク関数は、C API を呼び出さずに、xlretFailed を返します。
例
この例では、不正な引数を Excel12f 関数に渡して、デバッガーにメッセージを送信しています。
\SAMPLES\EXAMPLE\EXAMPLE.C
short WINAPI Excel12fExample(void)
{
Excel12f(xlcDisplay, 0, 1, 0);
return 1;
}