API设计-分配输出?

C API函数分配输出是一个好主意,还是让用户指定输出缓冲区?例如:

BOOL GetString(
    PWSTR *String
    );
...
PWSTR string;
GetString(&string);
Free(string);

VS

BOOL GetString(
    PWSTR Buffer,
    ULONG BufferSize,
    PULONG RequiredBufferSize
    );
...
// A lot more code than in the first case

更具体地说,我想知道为什么win32 API主要使用第二种情况(例如 GetWindowText , LookupAccountSid )。如果一个API函数知道输出有多大,为什么用户要猜测输出大小?我找不到任何关于为什么要使用第二个案例的信息。

另外:lookupaccountsid示例特别糟糕。在内部,它使用LSA API,它为调用者分配输出。然后lookupaccountsid让用户分配一个缓冲区(并猜测正确的缓冲区大小),当它可以从lsa返回输出时!为什么?