دالة MPI_Comm_free_keyval

تحرير مفتاح سمة extant.

بناء الجملة

int MPIAPI MPI_Comm_free_keyval(
   _Inout_ int *comm_keyval
);

المعلمات

• comm_keyval
  قيمة المفتاح.

القيمة المُرجعة

إرجاع MPI_SUCCESS عند النجاح. وإلا، فإن القيمة المرجعة هي رمز خطأ.

في Fortran، يتم تخزين القيمة المرجعة في المعلمة IERROR .

Fortran

    MPI_COMM_FREE_KEYVAL(COMM_KEYVAL, IERROR)
        INTEGER COMM_KEYVAL, IERROR

الملاحظات

تعين هذه الدالة قيمة keyval إلى MPI_KEYVAL_INVALID. لاحظ أنه ليس من الخطأ تحرير مفتاح سمة قيد الاستخدام، لأن الحر الفعلي لا يتم تحويله إلا بعد تحرير جميع المراجع (في الاتصالات الأخرى في العملية) إلى المفتاح. يجب تحرير هذه المراجع بشكل توضيحي من قبل البرنامج، إما عبر استدعاءات إلى MPI_Comm_delete_attr مثيل سمة واحد مجاني، أو عن طريق استدعاءات إلى MPI_Comm_free التي تحرر جميع مثيلات السمات المرتبطة بالتواصل الحر.

المتطلبات

منتج	حزمة HPC Pack 2012 MS-MPI القابلة لإعادة التوزيع، حزمة HPC Pack 2008 R2 MS-MPI القابلة لإعادة التوزيع، حزمة HPC Pack 2008 MS-MPI القابلة لإعادة التوزيع أو حزمة HPC Pack 2008 للعميل
الرأس	Mpi.h؛ Mpif.h
المكتبة	Msmpi.lib
Dll	Msmpi.dll

راجع أيضًا

وظائف التخزين المؤقت ل MPI