Khi nào nó cần thiết/thích hợp để sử dụng InAttribute và OutAttribute cho COM Interop

Question

Tôi đang cố gắng đi qua các mâu thuẫn của các định nghĩa interop COM chúng tôi đã phân tán trên các dự án khác nhau và thu thập chúng thành một vị trí duy nhất nhóm dev có thể có lợi. Một phần của nỗ lực này bao gồm làm sạch các định nghĩa đã được tích lũy qua nhiều năm.

Một số trong số này được mượn từ mã nguồn khác, một số được sao chép đúng nguyên văn từ pinvoke.net và một số được dịch trực tiếp từ tiêu đề SDK. Một điều tôi nhận thấy là không có sự nhất quán về thời điểm sử dụng các thuộc tính marshalling khác nhau, (ngay cả trong số các ví dụ về pinvoke.net, điều này là khá hay bị bỏ lỡ). Một phần của vấn đề là, tôi không nghĩ rằng bất cứ ai ở đây (bao gồm cả bản thân mình) hoàn toàn hiểu được khi các thuộc tính khác nhau là cần thiết hay không, hoặc những gì họ thực sự làm. Cho đến thời điểm này, nhận được những quyền này có vẻ là một sự kết hợp của phỏng đoán và thay đổi ngẫu nhiên cho đến khi COMExceptions ngừng xảy ra, nhưng tôi muốn nhiều bản dịch là đúng vì ai đó thực sự nhìn vào chúng và tuyên bố chúng như vậy.

Vì vậy, tôi bắt đầu với [In] và [Out]. Tôi biết hai thuộc tính đó có ý nghĩa gì: chúng thông báo cho marshaller biết hướng dữ liệu phải đi. Ví dụ: tôi giả sử trình so khớp, sẽ không làm phiền sao chép dữ liệu [In] trở lại người gọi hoặc biết rằng dữ liệu có thể cần được giải phóng ở phía bên lề, v.v. Những điều tôi không biết là:

1. Khi nào thì cần thiết để sử dụng các thuộc tính này? Đó là, khi nào thì hành vi marshalling mặc định sai sao cho các thuộc tính làm cho nó đúng?
2. Khi nào thì an toàn để sử dụng các thuộc tính này? Nghĩa là, sẽ xác định những gì đã được các hành vi mặc định thay đổi cách marshaller hoạt động?
3. Khi nào thì nguy hiểm để sử dụng các thuộc tính này? Tôi giả định rằng một cách rõ ràng đánh dấu một tham số đầu ra [In] là xấu, nhưng là đánh dấu một tham số đầu vào [In, Out] thực sự sẽ phá vỡ bất cứ điều gì?

Vì vậy, được đưa ra một phương pháp giao diện COM giả thuyết mà IDL trông như thế này:

HRESULT Foo(
    [in] ULONG a, 
    [out] ULONG * b 
    [in, out] ULONG * c); 

tôi có thể thấy điều này được dịch là bất kỳ những điều sau đây:

void Foo(
    uint cb, 
    out uint b, 
    ref uint c); 

void Foo(
    uint cb, 
    [Out] out uint b, 
    [In, Out] ref uint c); 

void Foo(
    [In] uint cb, 
    [Out] out uint b, 
    [In, Out] ref uint c); 

Có sự khác biệt chức năng giữa ba người đó? Có ai trong số họ được coi là "tốt hơn" so với những người khác vì lý do ngoài tính chính xác kỹ thuật?

Answer 1

Không, bạn không cần phải áp dụng bất kỳ thuộc tính nào trong số các thuộc tính này trong mã của riêng bạn. Tất cả đều tùy chọn và tự động áp dụng cho mã của bạn tùy thuộc vào loại thông số.

Về cơ bản, họ có từ khóa tương đương C# sau:

• Bạn nhận được [In] theo mặc định.
• Từ khóa ref giúp bạn [In, Out].
• Từ khóa out giúp bạn [Out].

Tất cả được ghi lại trong một bảng đẹp here.

Bạn chỉ cần sử dụng chúng khi bạn muốn thay đổi ngữ nghĩa ngụ ý hoặc thay đổi hành vi mặc định của trình so khớp. Ví dụ, bạn có thể đánh dấu một tham số được khai báo ref với thuộc tính [In] chỉ để ngăn chặn phần "ra" của marshaling.

Điều đó nói rằng, tôi thấy mình sử dụng chúng bởi vì chúng là một cách rất dễ dàng để làm cho mã tự tài liệu.