c++ - WinAPI混淆函数参数

Question

相关函数的 API 引用:RmStartSession .

代码:

#include <Windows.h>
#include <RestartManager.h>

/*
DWORD WINAPI
RmStartSession(
    _Out_ DWORD *pSessionHandle,
    _Reserved_ DWORD dwSessionFlags,
    _Out_writes_(CCH_RM_SESSION_KEY + 1) WCHAR strSessionKey[]);
*/

int main(int /*argc*/, char** /*argv*/)
{
    WCHAR sessionKey[CCH_RM_SESSION_KEY + 1];

    // 1.
    DWORD *sessionOne = nullptr;
    auto returnCodeOne = RmStartSession(sessionOne, NULL, sessionKey); // = 160 ERROR_BAD_ARGUMENTS

    // 2.
    DWORD sessionTwo = 0xFFFFFFF;
    DWORD *pSessionHandleTwo = &sessionTwo;
    auto returnCodeTwo = RmStartSession(pSessionHandleTwo, NULL, sessionKey); // = 0 ERROR_SUCCESS

    // 3.
    DWORD sessionThree = 0xFFFFFFF;
    auto returnCodeThree = RmStartSession(&sessionThree, NULL, sessionKey); // = 0 ERROR_SUCCESS

    return 0;
}  

我花了一段时间才意识到为什么 1. 给我一个 BAD_ARGUMENTS 错误，因为上面的所有变体都编译得很好并且是合法的语言结构。

问题在于该函数实际上需要一个指向有效对象的指针，并且仅使用该指针来修改对象，而不修改指针本身。因此，如果指针是 nullptr 则没有要修改的对象，函数本身不会分配对象。
(以上理解有误请指正)

话虽这么说，为什么函数没有定义为请求对 DWORD 的引用以明确它不能为 null，是否有特定原因在这里使用指针？< br/>我错过了什么？

Answer 1

这个问题有两个答案:

1. 这是一个 C api，因此 API 编写者无法获得引用。

2. 有一种观点认为对输出值参数使用引用是糟糕的 API 设计，应该始终使用指针，即使这意味着传递 nullptr 将是一场灾难.

想法是，基于引用的输出参数在调用站点确实令人困惑。看下面的代码:

void foo() {
   my_struct val;
   bar(val);
}

void foo_alt() {
   my_struct val;
   bar_alt(&val);
}

乍一看，人们不会期望 bar 在第一个示例中修改 val，但在第二个示例中会怀疑它。

仅通过查看调用站点来了解函数的作用是自文档化代码的基础，而可变引用通常会破坏这一点(除非它在函数名称中非常清楚)。