FsRtlDissectDbcs 函式 （ntifs.h）

假設有 ANSI 或雙位元組字元集 （DBCS） pathname 字串，FsRtlDissectDbcs 例程會傳回兩個字符串：一個包含字元串中找到的第一個檔名，另一個包含 pathname 字串的其餘未剖析部分。

語法

void FsRtlDissectDbcs(
  [in]  ANSI_STRING  Path,
  [out] PANSI_STRING FirstName,
  [out] PANSI_STRING RemainingName
);

參數

[in] Path

要剖析的路徑名稱字串。

[out] FirstName

pathname 字串中第一個檔名的指標。

[out] RemainingName

pathname 字串其餘未剖析部分的指標。

傳回值

沒有

言論

在輸入字串中，反斜杠會讀取為名稱分隔符。 字串中的名字假設包含字串開頭到第一個反斜杠前面字元的所有字元。 此規則只有一個例外：如果輸入字串中的第一個字元是反斜杠，則會忽略此字元，而且不會出現在輸出字串中。 字串的其餘部分是由緊接在字串中找到之名字后的所有字元所組成。

FsRtlDissectDbcs 不會檢查輸入字串中是否有非法字元。

下表顯示 FsRtlDissectDbcs的範例輸入和輸出值：

請注意，傳回時，輸出參數的 Buffer 成員會指向 PathBuffer 成員。 因此，呼叫端不應該為兩個輸出參數的 Buffer 成員配置記憶體，如下列範例所示：

.
.
.
/*
The FsRtlDissectDbcs routine will set the members
of the following two structures appropriately:
*/
UNICODE_STRING CurrentComponent;
UNICODE_STRING RemainingComponent;

/*
Do not allocate storage for the Buffer members of CurrentComponent
and RemainingComponent in that they will point into the previously
allocated storage of FullPathName's Buffer member:
*/
FsRtlDissectDbcs (FullPathName, &CurrentComponent, &RemainingComponent);
.
.
.

如需其他字串處理例程的詳細資訊，請參閱 Run-Time連結庫 （RTL） 例程。

要求

另請參閱

ANSI_STRING